【C#】分享一个可携带附加消息的增强消息框MessageBoxEx
【C#】分享一个可携带附加消息的增强消息框MessageBoxEx--------------201507160917更新---------------
无意中发现标准消息框在Windows7是有声音的，只是在Windows Server 2008(R2)无声，而我用的刚好是后者，所以误以为是MessageBeep API在所有NT6系统都不工作造成~汗，有人在stackoverflow也提过这问题。但我仍然决定使用PlaySound API，不做修改将声音处理交给PRocessIcon方法负责。之前考虑松耦合，所以将MessageBoxIcon和声音分开处理，但其实声音就是根据前者而来，两者天然就是耦合的，分开处理多此一举--------------201507091034更新---------------
首先感谢猿友E204在回复中的反馈。
解决双击【详细信息】按钮造成的Checked状态改变问题，办法是让ToggleButton忽略WM_LBUTTONDBLCLK消息修正收起详细信息区逻辑，改为直接取用plAttachZone.Height。之前是取ExpandHeight，会造成视觉体验问题--------------201507082014原文（已更新）---------------
适用于：.net 2.0+的Winform项目
样子：有损录制+制图的原因不可能原样展示出真实效果，可至文章结尾下载Demo体验。
功能和特点：相对父窗体居中可附带附加消息。附加消息可以是string和Exception类型，【详细信息】按钮会根据是否传入附加信息显示和隐藏。传入Exception实例时，呈现的是exception.ToString()，也就是可能携带StackTrace信息，所以如果你只是想呈现异常文本，还是老实传入ex.Message展开/收起附加信息时有动画效果。实用为王的你亦可设置EnableAnimate=false关闭动画效果在Windows Server 2008 R2（未测试其它服务器系统）也有声音反馈。标准消息框在个人系统（XP/Win7等）是有声音的，但在srv08却没有。同时亦提供了EnableSound属性允许你关闭声音反馈移除了标准MessageBox提供的IWin32Window、MessageBoxOptions和Help相关参数，原因是我用不到，懒得实现可拖拉改变消息框尺寸，消息文本和附加文本会随窗体大小重排。这是标准消息框未提供的能力。改变尺寸分两种情况有不同的行为：①详细信息未展开时，改变的是主消息区大小；②详细信息展开时，改变的是详细信息区的大小总体来说，此消息框比较适合用在需要反馈大量消息文本的场合，用标准消息框的话，文本太多可能会使消息框超出屏幕大小，比如codeproject.com上这位老兄举的例子，由于标准消息框不具备改变窗体大小的能力，将导致部分消息无法让用户看到。而就算没有超出屏幕，一下子让用户面对那么多消息文字，体验也不地道。使用本消息框就可以解决此类问题，比如可以将扼要信息显示在主消息区，将大量的明细消息（例如批量处理中的单项处理情况）、次要消息、异常信息等放置在详细信息区，由用户或IT支持人员自己去展开获取这些信息。同时，在没有附加消息的时候，你仍然可以像标准消息框一样使用它，所以，如果你跟我一样不会用到标准消息框的IWin32Window、MessageBoxOptions和Help相关参数的话，基本上你可以在整个项目中全程用此消息框替换掉标准消息框，别忘了相比标准消息框，它还具备了可缩放、相对父窗体居中等额外能力。总言之，你值得拥有。至于如果你担心性能问题，这个~我想这么说，我对自己的代码质量还是有点信心的。也希望能得大侠指出槽点，感激！
使用说明：先看公开成员：
//静态属性MessageBoxEx.EnableAnimateMessageBoxEx.EnableSound//静态方法MessageBoxEx.Show(string, string, string)MessageBoxEx.Show(string, string, string, MessageBoxButtons)MessageBoxEx.Show(string, string, string, MessageBoxButtons, MessageBoxIcon)MessageBoxEx.Show(string, string, string, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)MessageBoxEx.Show(string, string, Exception)MessageBoxEx.Show(string, string, Exception, MessageBoxButtons)MessageBoxEx.Show(string, string, Exception, MessageBoxButtons, MessageBoxIcon)MessageBoxEx.Show(string, string, Exception, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)
属性EnableAnimate和EnableSound上面提过，分别是用来启用/关闭动画、声音效果的，默认是都启用。俩属性影响范围是全局的，比如设置EnableAnimate = false后，之后弹出的MessageBoxEx都没有动画效果，直到重新设为true，EnableSound亦然。最佳实践是将它俩与用户偏好设置相关联，允许用户自主控制方法则只有一个：Show()，从重载列表你大概都能知道如何使用。其中第3个参数就是附加消息，可接受string和Exception类的实例，其余参数的位置和意义与标准消息框一致。简要示例如下：MessageBoxEx.Show("主消息", "标题", "附加消息", MessageBoxButtons.OK, MessageBoxIcon.None, MessageBoxDefaultButton.Button1);MessageBoxEx.Show("主消息", "标题", ex, MessageBoxButtons.OK, MessageBoxIcon.None, MessageBoxDefaultButton.Button1);
前3个参数可以放心为null，内部有处理，后面的枚举你也null不了，如果传入无效枚举值，会抛异常只有3个string参数的那个方法，后面俩参数是可选的。所以不讲究消息体验的你仍然可以这样使用：MessageBoxEx.Show("阿斯顿发");MessageBoxEx.Show("阿斯顿发", "士大夫");
方案源码：代码不少，原因自然是有的，有兴趣的童鞋请看后面的实现说明。另外，千万不要认为代码量跟性能有直接关系，有时候更多的代码恰恰是为了提升性能而存在，有时候则是为了健壮性。
using System;using System.ComponentModel;using System.Drawing;using System.IO;using System.Runtime.InteropServices;using System.Threading;using System.Windows.Forms;namespace AhDung.WinForm{ /// <summary> /// 可以携带详细信息的消息框 /// </summary> public static class MessageBoxEx { //异常消息文本 private const string InvalidButtonExString = "按钮参数不是有效的枚举项！"; private const string InvalidIconExString = "图标参数不是有效的枚举项！"; private const string InvalidDfButtonExString = "默认按钮参数不是有效的枚举项！"; /// <summary> /// 是否启用动画效果 /// </summary> public static bool EnableAnimate { get; set; } /// <summary> /// 是否启用声音反馈 /// </summary> public static bool EnableSound { get; set; } //静态构造 static MessageBoxEx() { //默认启用动画+声音 EnableAnimate = true; EnableSound = true; } #region 公开方法 /// <summary> /// 显示消息框 /// </summary> /// <param name="message">消息文本</param> /// <param name="caption">消息框标题</param> /// <param name="attachMessage">附加消息</param> public static DialogResult Show(string message, string caption = null, string attachMessage = null) { return ShowCore(message, caption, attachMessage, MessageBoxButtons.OK, MessageBoxIcon.None, MessageBoxDefaultButton.Button1); } /*下面这仨弄成重载而不是可选方法是为了避免不必要的参数检查*/ /// <summary> /// 显示消息框 /// </summary> /// <param name="message">消息文本</param> /// <param name="caption">消息框标题</param> /// <param name="attachMessage">附加消息</param> /// <param name="buttons">按钮组合</param> public static DialogResult Show(string message, string caption, string attachMessage, MessageBoxButtons buttons) { if (!Enum.IsDefined(typeof(MessageBoxButtons), buttons)) { throw new InvalidEnumArgumentException(InvalidButtonExString); } return ShowCore(message, caption, attachMessage, buttons, MessageBoxIcon.None, MessageBoxDefaultButton.Button1); } /// <summary> /// 显示消息框 /// </summary> /// <param name="message">消息文本</param> /// <param name="caption">消息框标题</param> /// <param name="attachMessage">附加消息</param> /// <param name="buttons">按钮组合</param> /// <param name="icon">图标</param> public static DialogResult Show(string message, string caption, string attachMessage, MessageBoxButtons buttons, MessageBoxIcon icon) { if (!Enum.IsDefined(typeof(MessageBoxButtons), buttons)) { throw new InvalidEnumArgumentException(InvalidButtonExString); } if (!Enum.IsDefined(typeof(MessageBoxIcon), icon)) { throw new InvalidEnumArgumentException(InvalidIconExString); } return ShowCore(message, caption, attachMessage, buttons, icon, MessageBoxDefaultButton.Button1); } /// <summary> /// 显示消息框 /// </summary> /// <param name="message">消息文本</param> /// <param name="caption">消息框标题</param> /// <param name="attachMessage">附加消息</param> /// <param name="buttons">按钮组合</param> /// <param name="icon">图标</param> /// <param name="defaultButton">默认按钮</param> public static DialogResult Show(string message, string caption, string attachMessage, MessageBoxButtons buttons, MessageBoxIcon icon, MessageBoxDefaultButton defaultButton) { if (!Enum.IsDefined(typeof(MessageBoxButtons), buttons)) { throw new InvalidEnumArgumentException(InvalidButtonExString); } if (!Enum.IsDefined(typeof(MessageBoxIcon), icon)) { throw new InvalidEnumArgumentException(InvalidIconExString); } if (!Enum.IsDefined(typeof(MessageBoxDefaultButton), defaultButton)) { throw new InvalidEnumArgumentException(InvalidDfButtonExString); } return ShowCore(message, caption, attachMessage, buttons, icon, defaultButton); } /********传入异常的重载********/ /// <summary> /// 显示消息框
