介紹一款C#中可攜帶附加訊息的增強訊息方塊(MessageBoxEx)

Y2J
發布: 2017-04-22 10:26:53
原創
3422 人瀏覽過

一個可攜帶附加訊息的增強訊息框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體驗。

介紹一款C#中可攜帶附加訊息的增強訊息方塊(MessageBoxEx)

功能與特性:

  • #相對父窗體居中

  • 可附帶附加訊息。附加訊息可以是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.EnableAnimate
MessageBoxEx.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>
 /// 显示消息框
 /// </summary>
 /// <param name="message">消息文本</param>
 /// <param name="caption">消息框标题</param>
 /// <param name="exception">异常实例</param>
 public static DialogResult Show(string message, string caption, Exception exception)
 {
  return Show(message, caption, exception == null ? string.Empty : exception.ToString());
 }

 /// <summary>
 /// 显示消息框
 /// </summary>
 /// <param name="message">消息文本</param>
 /// <param name="caption">消息框标题</param>
 /// <param name="exception">异常实例</param>
 /// <param name="buttons">按钮组合</param>
 public static DialogResult Show(string message, string caption, Exception exception, MessageBoxButtons buttons)
 {
  return Show(message, caption, exception == null ? string.Empty : exception.ToString(), buttons);
 }

 /// <summary>
 /// 显示消息框
 /// </summary>
 /// <param name="message">消息文本</param>
 /// <param name="caption">消息框标题</param>
 /// <param name="exception">异常实例</param>
 /// <param name="buttons">按钮组合</param>
 /// <param name="icon">图标</param>
 public static DialogResult Show(string message, string caption, Exception exception, MessageBoxButtons buttons, MessageBoxIcon icon)
 {
  return Show(message, caption, exception == null ? string.Empty : exception.ToString(), buttons, icon);
 }

 /// <summary>
 /// 显示消息框
 /// </summary>
 /// <param name="message">消息文本</param>
 /// <param name="caption">消息框标题</param>
 /// <param name="exception">异常实例</param>
 /// <param name="buttons">按钮组合</param>
 /// <param name="icon">图标</param>
 /// <param name="defaultButton">默认按钮</param>
 public static DialogResult Show(string message, string caption, Exception exception, MessageBoxButtons buttons, MessageBoxIcon icon, MessageBoxDefaultButton defaultButton)
 {
  return Show(message, caption, exception == null ? string.Empty : exception.ToString(), buttons, icon, defaultButton);
 }

 #endregion

 //内部方法,不检查参数有效性
 private static DialogResult ShowCore(string message, string caption, string attachMessage, MessageBoxButtons buttons, MessageBoxIcon icon, MessageBoxDefaultButton defaultButton)
 {
  using (MessageForm f = new MessageForm(message, caption, buttons, icon, defaultButton, attachMessage, EnableAnimate, EnableSound))
  {
  return f.ShowDialog();
  }
 }

 /*----------------
  下面是消息窗体相关
  ---------------*/

 /// <summary>
 /// 消息窗体
 /// </summary>
 /// <remarks>参数有效性由MessageBoxEx负责</remarks>
 private class MessageForm : Form
 {
  /* todo 存在问题:
  * 当消息区文本非常非常多时,且反复进行改变消息框窗口大小、位置、展开收起的操作,那么在某次展开时
  详细信息文本框可能会在原位置(即消息区内某rect)瞬闪一下,
  原因是文本框控件在显示时总会在原位置WM_NCPAINT + WM_ERASEBKGND一下,暂无解决办法。
  实际应用中碰到的几率很小,就算碰到,影响也可以忽略。
  */

  #region 控件初始化

  /// <summary>
  /// 必需的设计器变量。
  /// </summary>
  private System.ComponentModel.IContainer components = null;

  /// <summary>
  /// 清理所有正在使用的资源。
  /// </summary>
  /// <param name="disposing">如果应释放托管资源,为 true;否则为 false。</param>
  protected override void Dispose(bool disposing)
  {
  if (disposing && (components != null))
  {
   components.Dispose();
  }
  base.Dispose(disposing);
  }

  #region Windows 窗体设计器生成的代码

  /// <summary>
  /// 设计器支持所需的方法 - 不要
  /// 使用代码编辑器修改此方法的内容。
  /// </summary>
  private void InitializeComponent()
  {
  this.button3 = new System.Windows.Forms.Button();
  this.txbAttach = new TextBoxUnSelectAllable();
  this.button2 = new System.Windows.Forms.Button();
  this.button1 = new System.Windows.Forms.Button();
  this.plButtonsZone = new AhDung.WinForm.MessageBoxEx.MessageForm.PanelBasic();
  this.ckbToggle = new AhDung.WinForm.MessageBoxEx.MessageForm.ToggleButton(this.UseAnimate);
  this.plAttachZone = new AhDung.WinForm.MessageBoxEx.MessageForm.PanelBasic();
  this.lbMsg = new AhDung.WinForm.MessageBoxEx.MessageForm.MessageViewer();
  this.plButtonsZone.SuspendLayout();
  this.plAttachZone.SuspendLayout();
  this.SuspendLayout();
  // 
  // button3
  // 
  this.button3.Anchor = System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Right;
  this.button3.Location = new System.Drawing.Point(320, 8);
  this.button3.Margin = new System.Windows.Forms.Padding(3, 2, 3, 2);
  this.button3.Name = "button3";
  this.button3.Size = new System.Drawing.Size(85, 27);
  this.button3.TabIndex = 2;
  // 
  // txbAttach
  // 
  this.txbAttach.Anchor = ((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Bottom)
      | System.Windows.Forms.AnchorStyles.Left)
      | System.Windows.Forms.AnchorStyles.Right;
  this.txbAttach.Location = new System.Drawing.Point(10, 7);
  this.txbAttach.Margin = new System.Windows.Forms.Padding(3, 1, 3, 1);
  this.txbAttach.Name = "txbAttach";
  this.txbAttach.ReadOnly = true;
  this.txbAttach.Multiline = true;
  this.txbAttach.ScrollBars = System.Windows.Forms.ScrollBars.Vertical;
  this.txbAttach.Size = new System.Drawing.Size(395, 105);
  this.txbAttach.TabIndex = 0;
  // 
  // button2
  // 
  this.button2.Anchor = System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Right;
  this.button2.Location = new System.Drawing.Point(229, 8);
  this.button2.Margin = new System.Windows.Forms.Padding(3, 2, 3, 2);
  this.button2.Name = "button2";
  this.button2.Size = new System.Drawing.Size(85, 27);
  this.button2.TabIndex = 1;
  // 
  // button1
  // 
  this.button1.Anchor = System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Right;
  this.button1.Location = new System.Drawing.Point(138, 8);
  this.button1.Margin = new System.Windows.Forms.Padding(3, 2, 3, 2);
  this.button1.Name = "button1";
  this.button1.Size = new System.Drawing.Size(85, 27);
  this.button1.TabIndex = 0;
  // 
  // plButtonsZone
  // 
  this.plButtonsZone.Controls.Add(this.ckbToggle);
  this.plButtonsZone.Controls.Add(this.button1);
  this.plButtonsZone.Controls.Add(this.button2);
  this.plButtonsZone.Controls.Add(this.button3);
  this.plButtonsZone.Dock = System.Windows.Forms.DockStyle.Bottom;
  this.plButtonsZone.Location = new System.Drawing.Point(0, 96);
  this.plButtonsZone.Margin = new System.Windows.Forms.Padding(3, 1, 3, 1);
  this.plButtonsZone.Name = "plButtonsZone";
  this.plButtonsZone.Size = new System.Drawing.Size(415, 36);
  this.plButtonsZone.TabIndex = 1;
  // 
  // ckbToggle
  // 
  this.ckbToggle.Location = new System.Drawing.Point(10, 8);
  this.ckbToggle.Name = "ckbToggle";
  this.ckbToggle.Size = new System.Drawing.Size(93, 27);
  this.ckbToggle.TabIndex = 3;
  this.ckbToggle.Text = "详细信息(&D)";
  this.ckbToggle.CheckedChanged += this.ckbToggle_CheckedChanged;
  // 
  // plAttachZone
  // 
  this.plAttachZone.Controls.Add(this.txbAttach);
  this.plAttachZone.Dock = System.Windows.Forms.DockStyle.Fill;
  this.plAttachZone.Location = new System.Drawing.Point(0, 130);
  this.plAttachZone.Margin = new System.Windows.Forms.Padding(3, 2, 3, 2);
  this.plAttachZone.Name = "plAttachZone";
  this.plAttachZone.Size = new System.Drawing.Size(415, 114);
  this.plAttachZone.TabIndex = 2;
  this.plAttachZone.Visible = false;
  // 
  // lbMsg
  // 
  this.lbMsg.Dock = System.Windows.Forms.DockStyle.Fill;
  this.lbMsg.Icon = null;
  this.lbMsg.Location = new System.Drawing.Point(0, 0);
  this.lbMsg.Name = "lbMsg";
  this.lbMsg.Padding = new System.Windows.Forms.Padding(21, 18, 21, 18);
  //this.lbMsg.Size = new System.Drawing.Size(415, 96);
  this.lbMsg.TabIndex = 0;
  // 
  // FmMsg
  // 
  this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.None;
  //this.ClientSize = new System.Drawing.Size(415, 261);
  this.Controls.Add(this.lbMsg);
  this.Controls.Add(this.plButtonsZone);
  this.Controls.Add(this.plAttachZone);
  this.DoubleBuffered = true;
  this.MaximizeBox = false;
  this.Name = "MessageForm";
  this.Padding = new System.Windows.Forms.Padding(0, 0, 0, 17);
  this.ShowIcon = false;
  this.ShowInTaskbar = false;
  this.SizeGripStyle = System.Windows.Forms.SizeGripStyle.Show;
  this.plButtonsZone.ResumeLayout(false);
  this.plAttachZone.ResumeLayout(false);
  this.plAttachZone.PerformLayout();
  this.ResumeLayout(false);
  }

  #endregion

  private ToggleButton ckbToggle;
  private TextBoxUnSelectAllable txbAttach;
  private MessageViewer lbMsg;
  private System.Windows.Forms.Button button2;
  private System.Windows.Forms.Button button1;
  private PanelBasic plButtonsZone;
  private PanelBasic plAttachZone;
  private System.Windows.Forms.Button button3;

  #endregion

  /// <summary>
  /// 最大默认窗体客户区宽度
  /// </summary>
  const int MaxClientWidth = 700;

  string messageSound;//存储供PlaySound API使用的系统消息音别名,在ProcessIcon中赋值,OnShown中取用

  int expandHeight;
  /// <summary>
  /// 详细信息区展开高度
  /// </summary>
  private int ExpandHeight
  {
  get { return expandHeight < 150 ? 150 : expandHeight; }
  set { expandHeight = value; }
  }

  #region 属性

  /// <summary>
  /// 是否启用动画效果
  /// </summary>
  /// <remarks>此处还弄该属性是为了保证窗体类的独立性</remarks>
  private bool UseAnimate { get; set; }

  /// <summary>
  /// 是否启用声音反馈
  /// </summary>
  /// <remarks>此处还弄该属性是为了保证窗体类的独立性</remarks>
  private bool UseSound { get; set; }

  /// <summary>
  /// 消息按钮
  /// </summary>
  private MessageBoxButtons MessageButtons { get; set; }

  /// <summary>
  /// 消息图标
  /// </summary>
  private MessageBoxIcon MessageIcon { get; set; }

  /// <summary>
  /// 默认按钮
  /// </summary>
  private MessageBoxDefaultButton DefaultButton { get; set; }

  #endregion

  /// <summary>
  /// 创建消息窗体
  /// </summary>
  private MessageForm(bool enableAnimate)
  {
  this.UseAnimate = enableAnimate;//须尽早设置,要供展开按钮初始化用
  InitializeComponent();
  this.StartPosition = Form.ActiveForm == null ? FormStartPosition.CenterScreen : FormStartPosition.CenterParent;
  this.Font = SystemFonts.MessageBoxFont;

  //注册事件
  this.button1.Click += button_Click;
  this.button2.Click += button_Click;
  this.button3.Click += button_Click;
  this.plAttachZone.Resize += plAttachZone_Resize;
  }

  /// <summary>
  /// 创建消息窗体
  /// </summary>
  public MessageForm(string message, string caption, MessageBoxButtons buttons, MessageBoxIcon icon, MessageBoxDefaultButton defaultButton, string attachMessage, bool enableAnimate, bool enableSound)
  : this(enableAnimate)
  {
  this.lbMsg.Text = message;
  this.Text = caption;
  this.txbAttach.Text = attachMessage;
  this.MessageButtons = buttons;
  this.MessageIcon = icon;
  this.DefaultButton = defaultButton;
  this.UseSound = enableSound;
  }

  #region 重写基类方法

  protected override void OnLoad(EventArgs e)
  {
  //须在计算各种尺寸前搞掂
  ProcessIcon();
  ProcessButtons();

  this.MinimumSize = SizeFromClientSize(new Size(GetPanelButtonMinWidth(), GetClientMinHeight()));

  //参数意义定为客户区最大大小,所以需刨掉非客户区高度后传入
  this.ClientSize = this.GetPreferredSize(new Size(MaxClientWidth, Screen.PrimaryScreen.WorkingArea.Height - (this.Height - this.ClientSize.Height)));

  base.OnLoad(e);
  }

  protected override void OnShown(EventArgs e)
  {
  //设置默认按钮焦点。须在OnShown中设置按钮焦点才有用
  Button dfBtn;
  if ((dfBtn = this.AcceptButton as Button) != null)
  {
   dfBtn.Focus();
  }

  //播放消息提示音
  if (this.UseSound) { PlaySystemSound(this.messageSound); }

  base.OnShown(e);
  }

  //重写窗体参数
  protected override CreateParams CreateParams
  {
  get
  {
   CreateParams prms = base.CreateParams;

   if ((Convert.ToInt32(this.MessageButtons) & 1) == 0) //没有Cancel按钮时屏蔽关闭按钮,刚好在偶数项
   {
   prms.ClassStyle |= 0x200;
   }

   return prms;
  }
  }

  /// <summary>
  /// 计算合适的窗口尺寸
  /// </summary>
  /// <param name="proposedSize">该参数此处定义为客户区可设置的最大尺寸</param>
  public override Size GetPreferredSize(Size proposedSize)
  {
  int reservedHeight = plButtonsZone.Height + Padding.Bottom;
  Size size = lbMsg.GetPreferredSize(new Size(proposedSize.Width, proposedSize.Height - reservedHeight));
  size.Height += reservedHeight;
  return size;
  }

  #endregion

  #region 事件处理方法

  //展开收起
  private void ckbToggle_CheckedChanged(object sender, EventArgs e)
  {
  this.SuspendLayout();

  if (ckbToggle.Checked)
  {
   plButtonsZone.SendToBack();
   lbMsg.SendToBack();

   lbMsg.Dock = DockStyle.Top;
   plButtonsZone.Dock = DockStyle.Top;

   ChangeFormHeight(ExpandHeight);
   plAttachZone.Visible = true;
  }
  else
  {
   ExpandHeight = plAttachZone.Height;//为再次展开记忆高度
   plAttachZone.Visible = false;
   ChangeFormHeight(-plAttachZone.Height);//收起时直接取pl高度,不要取ExpandHeight

   plButtonsZone.SendToBack();

   plButtonsZone.Dock = DockStyle.Bottom;
   lbMsg.Dock = DockStyle.Fill;
  }

  this.ResumeLayout();
  }

  //按钮事件
  private void button_Click(object sender, EventArgs e)
  {
  this.DialogResult = (DialogResult)((sender as Button).Tag);
  }

  //用户手工收完详细区则触发折叠
  private void plAttachZone_Resize(object sender, EventArgs e)
  {
  if (ckbToggle.Checked && plAttachZone.Height == 0)
  {
   ckbToggle.Checked = false;
  }
  }

  #endregion

  #region 辅助+私有方法

  /// <summary>
  /// 处理按钮相关
  /// </summary>
  private void ProcessButtons()
  {
  this.ckbToggle.Visible = txbAttach.Text.Trim().Length != 0; //无详细信息就不显示展开按钮

  int btnCount = 3; //按钮数量

  switch (MessageButtons) //老实用case,可读点
  {
   case MessageBoxButtons.AbortRetryIgnore:
   button1.Text = "中止(&A)"; button1.Tag = DialogResult.Abort;
   button2.Text = "重试(&R)"; button2.Tag = DialogResult.Retry;
   button3.Text = "忽略(&I)"; button3.Tag = DialogResult.Ignore;
   break;
   case MessageBoxButtons.OK:
   button1.Visible = false;
   button2.Visible = false;
   button3.Text = "确定"; button3.Tag = DialogResult.OK;
   btnCount = 1;
   break;
   case MessageBoxButtons.OKCancel:
   button1.Visible = false;
   button2.Text = "确定"; button2.Tag = DialogResult.OK;
   button3.Text = "取消"; button3.Tag = DialogResult.Cancel;
   btnCount = 2;
   break;
   case MessageBoxButtons.RetryCancel:
   button1.Visible = false;
   button2.Text = "重试(&R)"; button2.Tag = DialogResult.Retry;
   button3.Text = "取消"; button3.Tag = DialogResult.Cancel;
   btnCount = 2;
   break;
   case MessageBoxButtons.YesNo:
   button1.Visible = false;
   button2.Text = "是(&Y)"; button2.Tag = DialogResult.Yes;
   button3.Text = "否(&N)"; button3.Tag = DialogResult.No;
   btnCount = 2;
   break;
   case MessageBoxButtons.YesNoCancel:
   button1.Text = "是(&Y)"; button1.Tag = DialogResult.Yes;
   button2.Text = "否(&N)"; button2.Tag = DialogResult.No;
   button3.Text = "取消"; button3.Tag = DialogResult.Cancel;
   break;
   default: break;
  }

  //仅有OK和有取消按钮时设CancelButton
  if ((int)MessageButtons == 0 || ((int)MessageButtons & 1) == 1)
  {
   this.CancelButton = button3;
  }

  //处理默认按钮
  if (btnCount == 1)
  {
   this.AcceptButton = button3;
  }
  else if (btnCount == 2)
  {
   this.AcceptButton = DefaultButton == MessageBoxDefaultButton.Button2 ? button3 : button2;
  }
  else
  {
   Button[] btnArray = { button1, button2, button3 };
   this.AcceptButton = btnArray[Convert.ToInt32(DefaultButton) / 0x100];
  }
  }

  /// <summary>
  /// 处理图标(含声音)
  /// </summary>
  private void ProcessIcon()
  {
  switch (MessageIcon)
  {
   //MessageBoxIcon.Information同样
   case MessageBoxIcon.Asterisk:
   lbMsg.Icon = SystemIcons.Information;
   messageSound = "SystemAsterisk";
   break;

   //MessageBoxIcon.Hand、MessageBoxIcon.Stop同样
   case MessageBoxIcon.Error:
   lbMsg.Icon = SystemIcons.Error;
   messageSound = "SystemHand";
   break;

   //MessageBoxIcon.Warning同样
   case MessageBoxIcon.Exclamation:
   lbMsg.Icon = SystemIcons.Warning;
   messageSound = "SystemExclamation";
   break;

   case MessageBoxIcon.Question:
   lbMsg.Icon = SystemIcons.Question;
   messageSound = "SystemAsterisk";//Question原本是没声音的,此实现让它蹭一下Information的
   break;

   default: //MessageBoxIcon.None
   lbMsg.Icon = null;
   messageSound = "SystemDefault";
   break;
  }
  }

  /// <summary>
  /// 计算窗体客户区最小高度
  /// </summary>
  private int GetClientMinHeight()
  {
  return lbMsg.MinimumHeight + plButtonsZone.Height + Padding.Bottom;
  }

  /// <summary>
  /// 计算按钮区最小宽度
  /// </summary>
  private int GetPanelButtonMinWidth()
  {
  int r = 20 /*左右Padding*/, visibleCount = -1 /*因为两个以上才会有间距*/;

  if (ckbToggle.Visible) { r += ckbToggle.Width; visibleCount++; }
  if (button1.Visible) { r += button1.Width * 3; visibleCount += 3; }
  else if (button2.Visible) { r += button2.Width * 2; visibleCount += 2; }
  else { r += button3.Width; visibleCount++; }

  if (visibleCount != -1) { r += visibleCount * 6; } //按钮间距

  return r;
  }

  /// <summary>
  /// 改变窗体高度。内部有动画处理
  /// </summary>
  /// <param name="increment">增量(负数即为减小高度)</param>
  private void ChangeFormHeight(int increment)
  {
  int finalHeight = this.Height + increment; //正确的目标高度

  if (!this.UseAnimate) //不使用动画
  {
   this.Height = finalHeight;
   return;
  }

  const int step = 8; //帧数

  for (int i = 0; i < step; i++)
  {
   if (i == step - 1) //最后一步直达目标
   {
   this.Height = finalHeight;
   return;
   }

   this.Height += increment / step;

   Application.DoEvents(); //必要
   Thread.Sleep(10);
  }
  }

  /// <summary>
  /// 播放系统事件声音
  /// </summary>
  /// <remarks>之所以不用MessageBeep API是因为这货在srv08上不出声,所以用PlaySound代替</remarks>
  private static void PlaySystemSound(string soundAlias)
  {
  PlaySound(soundAlias, IntPtr.Zero, 0x10000 /*SND_ALIAS*/| 0x1 /*SND_ASYNC*/);
  }

  [DllImport("winmm.dll", CharSet = CharSet.Auto)]
  private static extern bool PlaySound([MarshalAs(UnmanagedType.LPWStr)] string soundName, IntPtr hmod, int soundFlags);

  #endregion

  #region 嵌套类

  /// <summary>
  /// 基础面板
  /// </summary>
  private class PanelBasic : Control
  {
  public PanelBasic()
  {
   SetStyle(ControlStyles.AllPaintingInWmPaint, false);//关键,不然其上的ToolBar不正常
   SetStyle(ControlStyles.OptimizedDoubleBuffer, true);//重要。不设置的话控件绘制不正常
   SetStyle(ControlStyles.ContainerControl, true);
   SetStyle(ControlStyles.Selectable, false);
  }

  protected override void WndProc(ref Message m)
  {
   //屏蔽WM_ERASEBKGND。防止显示时在原位置快闪
   //不能通过ControlStyles.AllPaintingInWmPaint=true屏蔽
   //会影响其上的ToolBar
   if (m.Msg == 0x14) { return; }

   base.WndProc(ref m);
  }

  protected override void SetBoundsCore(int x, int y, int width, int height, BoundsSpecified specified)
  {
   //防Dock时面板短暂滞留在原位置
   base.SetBoundsCore(x, y, width, height, specified | BoundsSpecified.Y | BoundsSpecified.Width);
  }
  }

  /// <summary>
  /// 消息呈现控件
  /// </summary>
  private class MessageViewer : Control
  {
  const TextFormatFlags textFlags = TextFormatFlags.EndEllipsis //未完省略号
       | TextFormatFlags.WordBreak //允许换行
       | TextFormatFlags.NoPadding //无边距
       | TextFormatFlags.ExternalLeading //行间空白。NT5必须,不然文字挤在一起
       | TextFormatFlags.TextBoxControl; //避免半行

  const int IconSpace = 5; //图标与文本间距

  const float PreferredScale = 13;//最佳文本区块比例(宽/高)

  /// <summary>
  /// 最小高度。不要重写MinimumSize,那会在窗体移动和缩放时都会执行
  /// </summary>
  public int MinimumHeight
  {
   get
   {
   return (this.Icon != null ? Math.Max(this.Icon.Height, this.FontHeight) : this.FontHeight) + Padding.Vertical;
   }
  }

  /// <summary>
  /// 获取或设置图标
  /// </summary>
  public Icon Icon { get; set; }

  public MessageViewer()
  {
   this.SetStyle(ControlStyles.CacheText, true);
   this.SetStyle(ControlStyles.UserPaint, true);
   this.SetStyle(ControlStyles.AllPaintingInWmPaint, true);
   this.SetStyle(ControlStyles.Selectable, false);
   this.SetStyle(ControlStyles.ResizeRedraw, true); //重要

   this.DoubleBuffered = true; //双缓冲
   BackColor = Environment.OSVersion.Version.Major == 5 ? SystemColors.Control : Color.White;
  }

  //防Dock改变尺寸
  protected override void SetBoundsCore(int x, int y, int width, int height, BoundsSpecified specified)
  {
   base.SetBoundsCore(x, y, width, height, specified | BoundsSpecified.Size);
  }

  /// <summary>
  /// 计算合适的消息区尺寸
  /// </summary>
  /// <param name="proposedSize">该参数此处定义为此控件可设置的最大尺寸</param>
  /// <remarks>该方法对太长的单行文本有做比例优化处理,避免用户摆头幅度过大扭到脖子</remarks>
  public override Size GetPreferredSize(Size proposedSize)
  {
   if (proposedSize.Width < 10) { proposedSize.Width = int.MaxValue; }
   if (proposedSize.Height < 10) { proposedSize.Height = int.MaxValue; }

   int reservedWidth = Padding.Horizontal + (this.Icon == null ? 0 : (this.Icon.Width + IconSpace));

   Size wellSize = Size.Empty;
   if (!string.IsNullOrEmpty(this.Text))
   {
   //优化文本块宽高比例
   Size size = TextRenderer.MeasureText(this.Text, this.Font, new Size(proposedSize.Width - reservedWidth, 0), textFlags);//用指定宽度测量文本面积
   wellSize = Convert.ToSingle(size.Width) / size.Height > PreferredScale //过于宽扁的情况
    ? Size.Ceiling(GetSameSizeWithNewScale(size, PreferredScale))
    : size;

   //凑齐整行高,确保尾行显示
   int lineHeight = TextRenderer.MeasureText(" ", this.Font, new Size(int.MaxValue, 0), textFlags).Height;//单行高,Font.Height不靠谱
   int differ;
   wellSize.Height += (differ = wellSize.Height % lineHeight) == 0 ? 0 : (lineHeight - differ);
   }
   if (this.Icon != null)
   {
   wellSize.Width += this.Icon.Width + IconSpace;
   wellSize.Height = Math.Max(this.Icon.Height, wellSize.Height);
   }
   wellSize += Padding.Size;

   //不应超过指定尺寸。宽度在上面已确保不会超过
   if (wellSize.Height > proposedSize.Height) { wellSize.Height = proposedSize.Height; }

   return wellSize;
  }

  /// <summary>
  /// 重绘
  /// </summary>
  protected override void OnPaint(PaintEventArgs e)
  {
   Graphics g = e.Graphics;
   Rectangle rect = GetPaddedRectangle();

   //绘制图标
   if (this.Icon != null)
   {
   g.DrawIcon(this.Icon, Padding.Left, Padding.Top);

   //右移文本区
   rect.X += this.Icon.Width + IconSpace;
   rect.Width -= this.Icon.Width + IconSpace;

   //若文字太少,则与图标垂直居中
   if (this.Text.Length < 100)
   {
    Size textSize = TextRenderer.MeasureText(g, this.Text, this.Font, rect.Size, textFlags);
    if (textSize.Height <= this.Icon.Height)
    {
    rect.Y += (this.Icon.Height - textSize.Height) / 2;
    }
   }
   }

   //g.FillRectangle(Brushes.Gainsboro, rect);//test

   //绘制文本
   TextRenderer.DrawText(g, this.Text, this.Font, rect, Color.Black, textFlags);

   base.OnPaint(e);
  }

  /// <summary>
  /// 根据原尺寸,得到相同面积、且指定比例的新尺寸
  /// </summary>
  /// <param name="src">原尺寸</param>
  /// <param name="scale">新尺寸比例。需是width/height</param>
  private static SizeF GetSameSizeWithNewScale(Size src, float scale)
  {
   int sqr = src.Width * src.Height;//原面积
   double w = Math.Sqrt(sqr * scale);//新面积宽
   return new SizeF(Convert.ToSingle(w), Convert.ToSingle(sqr / w));
  }

  /// <summary>
  /// 获取刨去Padding的内容区
  /// </summary>
  private Rectangle GetPaddedRectangle()
  {
   Rectangle r = this.ClientRectangle;
   r.X += this.Padding.Left;
   r.Y += this.Padding.Top;
   r.Width -= this.Padding.Horizontal;
   r.Height -= this.Padding.Vertical;
   return r;
  }
  }

  /// <summary>
  /// 屏蔽全选消息的文本框
  /// </summary>
  private class TextBoxUnSelectAllable : TextBox
  {
  protected override void WndProc(ref Message m)
  {
   //EM_SETSEL
   if (m.Msg == 0xB1) { return; }

   base.WndProc(ref m);
  }
  }

  /// <summary>
  /// 包装ToolBarButton为单一控件
  /// </summary>
  private class ToggleButton : Control
  {
  /// <summary>
  /// 展开/收起图标数据
  /// </summary>
  const string ImgDataBase64 =
@"iVBORw0KGgoAAAANSUhEUgAAACAAAAAQCAYAAAB3AH1ZAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJ
bWFnZVJlYWR5ccllPAAAA3NJREFUeNqklVlPFEEQx/8zPccue6gorMd6gBegeCAQD4w+oCx+AInx
IB4EfTK8+g2MQUUTcBU8En0wmvigEkyMxgcTjRrUqHFVUBRQQaJGl2WPmbG6dzCLWUiESf7T0739
666urqqVDjVcxT9PAWkfqZKUY491ktpIzaRXGPv5L15J+dZIRx26dqAwf56c48+Cx+1CzDDR//13
/seevvx3HZ8OxmLxMzSvjhT5Z+Nx8UoKfHOu31e+qWwZPBkOMBkwTAvRuAE21QuvJwNz5s6U25++
rv365dtC+4SxifJsfeVWvsCJ2TOzqyo2FsHt1OBSFeiqTItIsOhHw7JgGBZM+s72TcOvX+GccHgw
k7qttgHj5slOLNE0tXZNSQGYJEEhiDEJusLoW4ZMfZnGJVv0QmHhYuiaup+zE+W5Aftyc/xMURRh
acJIKpowqDVhkhu5LCspiY6k0OIL5s9mdrCNyp9sDKL+6PExeW5AwOebigRNiiVMkoFIPIFwlLcG
huIm4mRI3DRpAQg38oPMmD6Nuz4wGn+koRGH64/hxr1HuHjl2qg8D8JcZ4ZTRCtLSDjT1Ijz51rS
5lfVzj2o2rWXXCzDPcnNh3L5K5WntdHYdAqng6cwa/EK+AuK8SDUSx65gUAlxR1ZkcqLLDBpkJ+S
R8yOvbXw+vx4GOoZsXlZyQqsK10pNlDpjlVZDPMs0FL55mATLl04C39+EWblFf3l2zs+w7jZii1b
Kkfw3IDOcDiS5/G4yLjknQcCAbrPW3j8plvMWlu8XGwOsblMASYjFh3i3S4SS+W3Vddg++6apJ8t
OwN4HHH/p+G5AW3f+gbyvB632DwGHigSyjdvpn4b9ElZWF9aJE6uMAanJsOlK3jdNcAXuE2y0vEQ
rcXfyeCT0vPcES0funoNRTJpgixSRUQsLbapogIbVq8S47rKCORShQvbX7437NI6Km8Ol9sxeG7A
i2g0Fnz2PAQ3TcjQGBw02UGWOqig8L7bweB1qCSFxHD3/nMMDkWDnJ0oP1yK6z529y1i8ovydaVL
wXOaXxl3W7K4yKKykY/Rdq8dofe9d+x6jonyw6WYu+Pyj5/hzLedPcU61dDJLh1T3E4BRgYjCHV0
4/qdJ+bn/h+naW41KZpiwLh5Kc3fMS+vNXaRybVT7YMdcM2228d6/ov/I8AAPfkI7yO+mM8AAAAA
SUVORK5CYII=";

  readonly bool isToggleMode;
  bool isChecked;
  bool useAnimate;
  readonly ImageList imgList;

  /// <summary>
  /// Checked改变后
  /// </summary>
  public event EventHandler CheckedChanged;

  /// <summary>
  /// 使用动画按钮效果
  /// </summary>
  private bool UseAnimate
  {
   get { return useAnimate; }
   set
   {
   if (useAnimate == value) { return; }

   useAnimate = value;
   if (IsHandleCreated) { this.CreateHandle(); }
   }
  }

  /// <summary>
  /// 获取或设置按钮是否处于按下状态
  /// </summary>
  [Description("获取或设置按钮是否处于按下状态"), DefaultValue(false)]
  public bool Checked
  {
   get
   {
   if (IsHandleCreated)
   {
    //保证isChecked与实情吻合。TB_ISBUTTONCHECKED
    isChecked = Convert.ToBoolean(SendMessage(this.Handle, 0x40A, IntPtr.Zero, IntPtr.Zero).ToInt32());
   }
   return isChecked;
   }
   set
   {
   if (isChecked == value || !isToggleMode) { return; }

   isChecked = value;

   if (IsHandleCreated)
   {
    //TB_CHECKBUTTON
    SendMessage(this.Handle, 0x402, IntPtr.Zero, new IntPtr(Convert.ToInt32(value)));
   }

   OnCheckedChanged(EventArgs.Empty);
   }
  }

  /// <summary>
  /// 创建ToolBarButtonControl
  /// </summary>
  public ToggleButton(bool useAnimate)
  {
   SetStyle(ControlStyles.UserPaint, false);
   SetStyle(ControlStyles.AllPaintingInWmPaint, true);
   SetStyle(ControlStyles.OptimizedDoubleBuffer, true);
   SetStyle(ControlStyles.ResizeRedraw, true);

   this.isToggleMode = true;//写死好了,独立版才提供设置
   this.UseAnimate = useAnimate;

   //将图标加入imageList
   imgList = new ImageList { ImageSize = new System.Drawing.Size(16, 16), ColorDepth = ColorDepth.Depth32Bit };
   using (MemoryStream ms = new MemoryStream(Convert.FromBase64String(ImgDataBase64)))
   {
   imgList.Images.AddStrip(Image.FromStream(ms));
   }
  }

  /// <summary>
  /// 执行左键单击
  /// </summary>
  public void PerformClick()
  {
   SendMessage(this.Handle, 0x201, new IntPtr(0x1), IntPtr.Zero);//WM_LBUTTONDOWN
   Application.DoEvents();
   SendMessage(this.Handle, 0x202, IntPtr.Zero, IntPtr.Zero); //WM_LBUTTONUP
  }

  protected override void WndProc(ref Message m)
  {
   //忽略鼠标双击消息,WM_LBUTTONDBLCLK
   if (m.Msg == 0x203) { return; }

   //有节操的响应鼠标动作
   if ((m.Msg == 0x201 || m.Msg == 0x202) && (!this.Enabled || !this.Visible))
   {
   return;
   }
   base.WndProc(ref m);
  }

  //创建ToolBar
  protected override CreateParams CreateParams
  {
   get
   {
   CreateParams prms = base.CreateParams;
   prms.ClassName = "ToolbarWindow32";
   prms.Style = 0x40000000
    | 0x10000000
    //| 0x2000000 //WS_CLIPCHILDREN
    //| 0x8000
    | 0x1
    | 0x4
    | 0x8
    | 0x40
    | 0x1000 //TBSTYLE_LIST,图标文本横排
    ;
   if (UseAnimate) { prms.Style |= 0x800; }//TBSTYLE_FLAT。flat模式在NT6.x下,按钮按下会有动画效果

   prms.ExStyle = 0;

   return prms;
   }
  }

  protected override void OnHandleCreated(EventArgs e)
  {
   base.OnHandleCreated(e);

   //设置imgList
   SendMessage(this.Handle, 0x430, IntPtr.Zero, imgList.Handle);//TB_SETIMAGELIST

   //准备添加按钮
   int btnStructSize = Marshal.SizeOf(typeof(TBBUTTON));
   SendMessage(this.Handle, 0x41E, new IntPtr(btnStructSize), IntPtr.Zero);//TB_BUTTONSTRUCTSIZE,必须在添加按钮前

   //构建按钮信息
   TBBUTTON btnStruct = new TBBUTTON
   {
   //iBitmap = 0,
   //idCommand = 0,
   fsState = 0x4, //TBSTATE_ENABLED
   iString = SendMessage(this.Handle, 0x44D, 0, this.Text + &#39;\0&#39;)//TB_ADDSTRING
   };
   if (this.isToggleMode) { btnStruct.fsStyle = 0x2; }//BTNS_CHECK。作为切换按钮时

   IntPtr btnStructStart = IntPtr.Zero;
   try
   {
   btnStructStart = Marshal.AllocHGlobal(btnStructSize);//在非托管区创建一个指针
   Marshal.StructureToPtr(btnStruct, btnStructStart, true);//把结构体塞到上述指针

   //添加按钮
   SendMessage(this.Handle, 0x444, new IntPtr(1)/*按钮数量*/, btnStructStart);//TB_ADDBUTTONS。从指针取按钮信息

   //设置按钮尺寸刚好为ToolBar尺寸
   AdjustButtonSize();
   }
   finally
   {
   if (btnStructStart != IntPtr.Zero) { Marshal.FreeHGlobal(btnStructStart); }
   }
  }

  protected override bool ProcessCmdKey(ref Message m, Keys keyData)
  {
   //将空格和回车作为鼠标单击处理
   if (m.Msg == 0x100 && (keyData == Keys.Enter || keyData == Keys.Space))
   {
   PerformClick();
   return true;
   }

   return base.ProcessCmdKey(ref m, keyData);
  }

  /// <summary>
  /// 处理助记键
  /// </summary>
  protected override bool ProcessMnemonic(char charCode)
  {
   if (IsMnemonic(charCode, this.Text))
   {
   PerformClick();
   return true;
   }

   return base.ProcessMnemonic(charCode);
  }

  protected override void OnClick(EventArgs e)
  {
   //忽略鼠标右键
   MouseEventArgs me = e as MouseEventArgs;
   if (me != null && me.Button != System.Windows.Forms.MouseButtons.Left)
   { return; }

   //若是切换模式,直接引发Checked事件(不要通过设置Checked属性引发,因为OnClick发送之前就已经Check了)
   //存在理论上的不可靠,但暂无更好办法
   if (isToggleMode)
   { this.OnCheckedChanged(EventArgs.Empty); }

   base.OnClick(e);
  }

  //重绘后重设按钮尺寸
  protected override void OnInvalidated(InvalidateEventArgs e)
  {
   base.OnInvalidated(e);
   AdjustButtonSize();
  }

  /// <summary>
  /// 引发CheckedChanged事件
  /// </summary>
  protected virtual void OnCheckedChanged(EventArgs e)
  {
   SetImageIndex(this.Checked ? 1 : 0);

   if (CheckedChanged != null) { CheckedChanged(this, e); }
  }

  /// <summary>
  /// 设置图标索引
  /// </summary>
  private void SetImageIndex(int index)
  {
   //TB_CHANGEBITMAP
   SendMessage(this.Handle, 0x42B, IntPtr.Zero, new IntPtr(index));
  }

  /// <summary>
  /// 调整按钮尺寸刚好为ToolBar尺寸
  /// </summary>
  private void AdjustButtonSize()
  {
   IntPtr lParam = new IntPtr((this.Width & 0xFFFF) | (this.Height << 0x10)); //MakeLParam手法
   SendMessage(this.Handle, 0x41F, IntPtr.Zero, lParam); //TB_SETBUTTONSIZE
  }

  #region Win32 API

  [DllImport("user32.dll", CharSet = CharSet.Auto)]
  private static extern IntPtr SendMessage(IntPtr hWnd, int msg, IntPtr wParam, IntPtr lParam);

  [DllImport("user32.dll", CharSet = CharSet.Auto)]
  private static extern IntPtr SendMessage(IntPtr hWnd, int msg, int wParam, string lParam);

  [StructLayout(LayoutKind.Sequential)]
  private struct TBBUTTON
  {
   public int iBitmap;
   public int idCommand;
   public byte fsState;
   public byte fsStyle;
   public byte bReserved0;
   public byte bReserved1;
   public IntPtr dwData;
   public IntPtr iString;
  }

  #endregion
  }

  #endregion
 }
 }
}
登入後複製

实现说明:

以下内容献给童鞋。这里先贴个概要类图,详细的后面有完整Demo下载,你可以down回去慢慢研究。

介紹一款C#中可攜帶附加訊息的增強訊息方塊(MessageBoxEx)

若干Show方法都是调用私有的ShowCore方法,这个是模仿标准MessageBox的命名。至于意义,是因为公开方法要做参数检查,检查合格后的代码则可以重用。另外,几个存在参数检查的方法都是调用内部方法,而不是调参数最全的那个重载,也是因为要尽量避免无谓的参数检查,因为参数最全的那个公开方法,参数检查自然是做的最多的,那么少参方法本来已经能确保传入的是合法参数,却因为调它,就会造成无谓的检查,而调内部方法则可以避免,因为内部方法就应该设计为不做或少做参数检查的。啰嗦这个是想提醒初学者注意这些细节上的处理,性能要从细处抓起

静态类MessageBoxEx内部维护着一个MessageForm窗体类(下文简称MsgFm),每次Show都会实例化一个MsgFm,show完即释放。几乎所有能力都是由后者提供,前者只是简单的对其封装和暴露,所以下面主要说MsgFm的事。另外,根据传入的MessageBoxButtons有无Cancel项,会启用/屏蔽窗体右上角的关闭按钮,因为单击关闭按钮的对话框结果始终是DialogResult.Cancel,所以如果不屏蔽,在传入YesNo这样的参数时候,调用者可能因为用户去点关闭按钮而得到Yes、No以外的结果。标准消息框也是有这样的屏蔽处理的

MsgFm由3个控件区构成,分别是主消息区、按钮区、详细信息区

    主訊息區是單一控制項:MessageViewer,直接繼承自Control寫成。一開始是考慮用現成的Label控件,但發現後者的圖文混排效果差強人意(不要扯這個成語本來的意思),它是把文字直接蓋在圖標上,呵呵,大概此控件的編寫者本意就是要把Image當BackgroundImage用,所以不得已另寫一個MessageViewer。 MV主要做了兩個事,繪製(圖標和文字)+根據內容確定自身尺寸,另外它還控制了最小高度,避免圖標和文字整體被淹沒
    按鈕區 由一個容器類別控制項PanelBasic托起4個按鈕。 PB同樣是繼承自Control,沒有直接選用Panel的原因,主要是Panel會在設定Dock時跳一下,根源在Control.SetBoundsCore的specified參數通知了無謂的信息,所以乾脆直接繼承Control重寫該方法,順便處理一下訊息,解決瞬閃的問題,具體原因這裡不細說,註解裡有簡短說明,總之相信我不是蛋痛就行了。另外按鈕區會根據按鈕可見情況控制最小寬度,它與上面的MessageViewer的最小高度共同構成了整個對話框的最小尺寸MinimumSize
    PanelBasic#上的4個按鈕分別是【詳細資料】按鈕和其它3個對話框指令按鈕。仨按鈕根據傳入的MessageBoxButtons參數動態處理(按鈕文字、是否可見等),沒什麼好說的。 【詳細資料】按鈕(ToggleButton)則費了番功夫,該按鈕從外觀上就可以看出不是標準的Button,事實上它是個工具列按鈕:ToolBarButton,屬於ToolBar上的Item,本身不是獨立的控制項(直接繼承自Component)。這裡扯一點,由於.net 2.0起MS就建議用新式的ToolStrip代替ToolBar,類似的還有MenuStrip代替MainMenu、StatusStrip代替StatusBar、ContextMenuStrip代替ContextMenu,VS2010更是默認就不在工具箱顯示這些「控制項」(有些不算控制),所以估計知道的新童鞋不多。後者都是原生的win32元件,前者則是純.net實作的,有Office2003的控制風格。總之對於有win32 native控的我來說,對這些被建議替代的老式控制有特別的情結。所以這個ToggleButton實際上是由一個ToolBar和一個ToolBarButton組成的看起來像一個單一控件的東西,那為什麼它還是繼承自Control而不是直接用ToolBar呢,我承認這裡面有練手的原因(遲些我可能會寫一篇【教你一步步封裝一個Win32原生控制】的文章),Hmmm~也就這個原因了,但它雖然增加了程式碼量,但請務必相信效能不比直接用ToolBar差,理論上還要好過,因為作為一個完備的ToolBar,MS要考慮的情況相當多,顯然處理也少不了,而我這個ToggleButton由於只負責一個單一按鈕的功能,所以其實很Simple很Lite~聰明的你會理解的。最後為什麼要費事弄成ToolBarButton而不是直接用一個Button,是因為我看上了mstsc.exe的這個效果:

介紹一款C#中可攜帶附加訊息的增強訊息方塊(MessageBoxEx)

順便說一點,EnableAnimate屬性有作用到該按鈕,原理是當ToolBar具有Flat樣式的時候,按鈕按下和彈起就有動畫效果,否則沒有

     最後是詳細資料區 ,由一個PanelBasic托起一個簡單改造過的TextBox構成。幹嘛不單純用一個TextBox,而要在它底下墊一層呢,是因為在XP上的效果不好(控件狗要考慮的情況很多了啦好不好),XP窗口邊框不如NT6粗,不加點襯料的話太單薄。話說回來,PanelBasic上面已說過,而所謂改造過的這個TextBox叫TextBoxUnSelectAllable,就乾一件事,忽略全選消息(EM_SETSEL),避免焦點移進去的時候藍瑩瑩一大片嚇到觀眾。而為什麼不用標準TextBox的Enter事件取消全選,一個字~太low

#尚存在一個問題,這個註解裡也有坦白,就是當主訊息文字非常非常多時~大概整屏那麼長(這其實是不正確的使用姿勢,上面說過,大量資訊應該放詳細資訊區),如果對對話框反覆拖拉、展開/收起,那麼在某次展開時,TextBoxUnSelectAllable會瞬間在主訊息區閃一下,這個問題在PanelBasic得到了完美的解決,但TextBox實在無能為力,嘗試過直接用原生Edit控制也如此,所以暫時留著吧,哪有沒缺憾的人生呢

關於聲音,由於MessageBeep API在srv08系統無聲,所以用了PlaySound API取代。另外,讓原本沒聲音的MessageBoxIcon.Question蹭SystemIcons.Information的聲音,不能歧視人Question

#

最後,【詳細資料】按鈕上那兩個圖示(展開、收起各一個)是我畫的,本來想揀mstsc.exe上的,但發現效果不如意,還不如自己畫

說了這麼多,自以為很理想的實現,可能槽點也不少,再次懇請路過大俠指點,謝謝。

最後,Demo在此,裡面有個Tester供你體驗:

介紹一款C#中可攜帶附加訊息的增強訊息方塊(MessageBoxEx)

以上是介紹一款C#中可攜帶附加訊息的增強訊息方塊(MessageBoxEx)的詳細內容。更多資訊請關注PHP中文網其他相關文章!

相關標籤:
c#
來源:php.cn
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板