語言

如何處理表單中的鍵盤輸入訊息

在訊息到達控制項之前,Windows Form 提供在表單層級處理鍵盤訊息的能力。 本文會説明如何完成這項工作。

處理鍵盤訊息

處理作用中表單的 KeyPress 或 KeyDown 事件,並將表單的 KeyPreview 屬性設為 true。 此特性使鍵盤輸入先於表單上的任何控制項先到達表單。 下列程式碼範例透過偵測所有數字鍵並使用 1、4 和 7 來處理 KeyPress 事件。

// Detect all numeric characters at the form level and consume 1, 4, and 7.
// Form.KeyPreview must be set to true for this event handler to be called.
void Form1_KeyPress(object sender, KeyPressEventArgs e)
{
    if (char.IsDigit(e.KeyChar))
    {
        MessageBox.Show($"Form.KeyPress: '{e.KeyChar}' pressed.");

        switch (e.KeyChar)
        {
            case '1':
            case '4':
            case '7':
                MessageBox.Show($"Form.KeyPress: '{e.KeyChar}' consumed.");
                e.Handled = true;
                break;
        }
    }
}
' Detect all numeric characters at the form level and consume 1, 4, and 7.
' Form.KeyPreview must be set to true for this event handler to be called.
Private Sub Form1_KeyPress(sender As Object, e As KeyPressEventArgs)
    If Char.IsDigit(e.KeyChar) Then
        MessageBox.Show($"Form.KeyPress: '{e.KeyChar}' pressed.")

        Select Case e.KeyChar
            Case "1"c, "4"c, "7"c
                MessageBox.Show($"Form.KeyPress: '{e.KeyChar}' consumed.")
                e.Handled = True
        End Select
    End If

End Sub

什麼時候 KeyPreview 還不夠

設定 Form.KeyPreview = true 並不保證每個鍵都能到達表單層級的事件處理程序。 某些鍵會在標準表單事件執行前經過預處理。 理解這些例外對於正確處理指令鍵、對話框鍵及控制鍵特定輸入非常重要。

指令與對話框鍵預處理

在表單層級鍵盤事件觸發前,Windows 會先透過以下方法(依序)預處理某些按鍵:

  1. ProcessCmdKey: 攔截命令鍵,如選單快捷鍵與加速器。 若此方法回傳 true,則該金鑰被消耗且不會觸發事件。
  2. IsInputKey:決定某個按鍵應觸發 KeyDown 事件,還是移至 ProcessDialogKey。
  3. ProcessDialogKey: 處理導航鍵(Esc、Tab、Return 和方向鍵)。 如果處理完成,事件不會觸發。

若聚焦控制項在預處理時消耗了金鑰,表單無論如何 KeyPreview都不會接收該鍵。

繞過表單層級處理器的特殊情況

  • Enter 和 Escape:這些按鍵可能會在到達表單事件之前先由 AcceptButton 和 CancelButton 處理。
  • Tab 鍵:通常會被控制項的焦點管理機制攔截,因此不會傳遞到表單處理常式。
  • 選單快捷鍵:Alt 鍵組合由選單預處理處理。

在表單層級攔截命令鍵

若要在表單層級處理命令鍵(包括選單快速鍵和對話方塊鍵),請在表單上覆寫 ProcessCmdKey。 此程序會在前處理期間執行,且於標準表單事件之前。

protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
{
    // Intercept Ctrl+A for custom handling
    if (keyData == (Keys.Control | Keys.A))
    {
        MessageBox.Show("Ctrl+A intercepted at form level");
        return true; // Mark as handled
    }

    // Pass other keys to the base handler
    return base.ProcessCmdKey(ref msg, keyData);
}
Protected Overrides Function ProcessCmdKey(ByRef msg As Message, keyData As Keys) As Boolean
    ' Intercept Ctrl+A for custom handling
    If keyData = (Keys.Control Or Keys.A) Then
        MessageBox.Show("Ctrl+A intercepted at form level")
        Return True ' Mark as handled
    End If

    ' Pass other keys to the base handler
    Return MyBase.ProcessCmdKey(msg, keyData)
End Function

對於應在特定控制項中觸發標準事件的按鍵,請在該控制項上使用 PreviewKeyDown,並將 IsInputKey 設為 true。

另請參閱