語言
在訊息到達控制項之前,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 會先透過以下方法(依序)預處理某些按鍵:
-
ProcessCmdKey: 攔截命令鍵,如選單快捷鍵與加速器。 若此方法回傳
true,則該金鑰被消耗且不會觸發事件。 - IsInputKey:決定某個按鍵應觸發 KeyDown 事件,還是移至 ProcessDialogKey。
- 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。