.NET Windows Forms 開發實戰：模式對話框完整指南與最佳實務

在 Windows Forms 應用程式中，模式對話框 是引導使用者完成特定任務（如設定選項、輸入資料、確認動作）的核心 UI 元件。本文系統整理模式視窗的屬性設定、按鈕交互設計、開啟/關閉流程控制、父子視窗資料傳遞七大模式，以及 .NET 內建常用對話框，助你打造專業、易用的桌面應用體驗。

一、打造標準模式視窗的屬性設定

透過設計師屬性視窗或程式碼設定下列屬性，即可符合 Windows UI 標準規範：

// 程式碼一次設定
this.StartPosition = FormStartPosition.CenterParent;
this.HelpButton = true;
this.MaximizeBox = false;
this.MinimizeBox = false;
this.ShowIcon = false;
this.ShowInTaskbar = false;
this.FormBorderStyle = FormBorderStyle.FixedDialog;
// this.ControlBox = false; // 視情況啟用

二、按鍵交互：AcceptButton 與 CancelButton

設定這兩個屬性，讓使用者能以 Enter、Esc 快速完成或取消操作：

// 設計師中拖曳兩個 Button：btnOK、btnCancel
this.AcceptButton = this.btnOK;   // Enter 鍵觸發
this.CancelButton = this.btnCancel; // Esc 鍵觸發

細節提醒：

• 焦點在 btnCancel 時按 Enter 會觸發 btnCancel 而非 btnOK。
• 焦點在第三個按鈕時，Enter 觸發該按鈕。
• 鍵盤觸發不會顯示按鈕「按下」的視覺效果，滑鼠點擊則會。

三、模式視窗的開啟與關閉流程控制

1. 開啟方式與 Owner 關係

var form = new OptionForm();
// form.ShowDialog(); // 無 Owner
form.ShowDialog(this); // 指定 Owner 為 this (主視窗)

• ShowDialog(IWin32Window owner)：建立擁有者關係，子視窗會隨父視窗最小化/關閉、永不顯示於父視窗之後。
• 子視窗內可透過 this.Owner as MainForm 取得父視窗參考；若用無參數 ShowDialog()，Owner 為 null。

2. DialogResult 回傳值與關閉控制

ShowDialog() 回傳 DialogResult 列舉：OK、Cancel、Yes、No、Abort、Retry、Ignore、None。

傳統寫法（三個事件，程式碼冗長）

// FormClosing、btnOK_Click、btnCancel_Click 三個事件處理函式
private void btnOK_Click(object sender, EventArgs e)
{
    if (string.IsNullOrEmpty(txtPath.Text))
    {
        MessageBox.Show("請輸入路徑！");
        txtPath.Focus();
    }
    else
        this.DialogResult = DialogResult.OK;
}

private void btnCancel_Click(object sender, EventArgs e)
{
    this.DialogResult = DialogResult.Cancel;
}

private void OptionForm_FormClosing(object sender, FormClosingEventArgs e)
{
    if (this.DialogResult != DialogResult.OK && this.DialogResult != DialogResult.Cancel)
        e.Cancel = true; // 防止使用者點右上角 X 關閉
}

簡潔寫法（利用 Button.DialogResult 屬性，僅需一個事件）

// 建構函式中設定按鈕預設 DialogResult
public OptionForm()
{
    InitializeComponent();
    btnOK.DialogResult = DialogResult.OK;
    btnCancel.DialogResult = DialogResult.Cancel;
}

// 僅處理驗證失敗時阻止關閉
private void btnOK_Click(object sender, EventArgs e)
{
    if (string.IsNullOrEmpty(txtPath.Text))
    {
        MessageBox.Show("請輸入路徑！");
        txtPath.Focus();
        this.DialogResult = DialogResult.None; // 關鍵：重設為 None 取消關閉
    }
    // 驗證通過時，btnOK.DialogResult = OK 會自動關閉視窗並回傳 OK
}

原理： 當按鈕的 DialogResult 屬性非 None 時，點擊該按鈕會自動設定表單 DialogResult 並關閉視窗。在 Click 事件中將 this.DialogResult = DialogResult.None 可中斷關閉流程。

四、父子視窗資料傳遞七大模式

重點範例：事件模式（推播資料回父視窗）

// 1. 定義事件參數類別
public class OptionSettingEventArgs : EventArgs
{
    public string ChangedPath { get; private set; }
    public OptionSettingEventArgs(string path) { ChangedPath = path; }
}

// 2. 子視窗定義並引發事件
public partial class OptionForm : Form
{
    public event EventHandler<OptionSettingEventArgs> OptionSettingChanged;

    protected virtual void OnOptionSettingChanged(OptionSettingEventArgs e)
    {
        OptionSettingChanged?.Invoke(this, e);
    }

    private void btnBrowse_Click(object sender, EventArgs e)
    {
        using (var dlg = new FolderBrowserDialog())
        {
            if (dlg.ShowDialog(this) == DialogResult.OK && txtPath.Text != dlg.SelectedPath)
            {
                txtPath.Text = dlg.SelectedPath;
                OnOptionSettingChanged(new OptionSettingEventArgs(dlg.SelectedPath));
            }
        }
    }
}

// 3. 父視窗訂閱
var form = new OptionForm();
form.OptionSettingChanged += (s, e) => MessageBox.Show($"新路徑：{e.ChangedPath}");
form.ShowDialog();

五、.NET 內建常用模式對話框速查

注意： 繼承自 CommonDialog 或 FileDialog 的類別，均使用 ShowDialog() 或 ShowDialog(IWin32Window) 開啟模式視窗；PrintPreviewDialog 繼承 Form，亦可用 Show() 非模式開啟。

總結

掌握模式視窗的標準屬性、按鍵交互、關閉流程控制、資料傳遞模式與內建對話框，能讓你的 WinForms 應用擁有專業、一致且符合使用者直覺的操作體驗。實務上常採用「公開屬性 + 事件」組合，兼顧型別安全與鬆耦合。