【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>        /// 显示消息框