Control.PreviewKeyDown Olay
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Odak bu denetimdeyken KeyDown bir tuşa basıldığında olaydan önce gerçekleşir.
public:
event System::Windows::Forms::PreviewKeyDownEventHandler ^ PreviewKeyDown;
public event System.Windows.Forms.PreviewKeyDownEventHandler PreviewKeyDown;
public event System.Windows.Forms.PreviewKeyDownEventHandler? PreviewKeyDown;
member this.PreviewKeyDown : System.Windows.Forms.PreviewKeyDownEventHandler
Public Custom Event PreviewKeyDown As PreviewKeyDownEventHandler
Olay Türü
Örnekler
Aşağıdaki kod örneğinde içeren bir Button gösterilmektedir ContextMenuStrip.
Button odak olduğunda ve YUKARI OK veya AŞAĞI OK tuşlarına bastığınızda, ContextMenuStrip görünür. Olay işleyici, PreviewKeyDown YUKARI OK veya AŞAĞI OK tuşlarına basıldığında bunu algılar ve özelliğini olarak true
ayarlarIsInputKey. Bu, öğesini görüntüleyebilmeniz için olayı tetikler KeyDownContextMenuStrip. Olay işleyicisine PreviewKeyDown özelliğini ayarlamak IsInputKey dışında herhangi bir mantık koymamalısınız. Bunun yerine mantığınızı olay işleyicisine KeyDown yerleştirmeniz gerekir.
public Form1()
{
InitializeComponent();
// Form that has a button on it
button1.PreviewKeyDown +=new PreviewKeyDownEventHandler(button1_PreviewKeyDown);
button1.KeyDown += new KeyEventHandler(button1_KeyDown);
button1.ContextMenuStrip = new ContextMenuStrip();
// Add items to ContextMenuStrip
button1.ContextMenuStrip.Items.Add("One");
button1.ContextMenuStrip.Items.Add("Two");
button1.ContextMenuStrip.Items.Add("Three");
}
// By default, KeyDown does not fire for the ARROW keys
void button1_KeyDown(object sender, KeyEventArgs e)
{
switch (e.KeyCode)
{
case Keys.Down:
case Keys.Up:
if (button1.ContextMenuStrip != null)
{
button1.ContextMenuStrip.Show(button1,
new Point(0, button1.Height), ToolStripDropDownDirection.BelowRight);
}
break;
}
}
// PreviewKeyDown is where you preview the key.
// Do not put any logic here, instead use the
// KeyDown event after setting IsInputKey to true.
private void button1_PreviewKeyDown(object sender, PreviewKeyDownEventArgs e)
{
switch (e.KeyCode)
{
case Keys.Down:
case Keys.Up:
e.IsInputKey = true;
break;
}
}
Public Class Form1
Public Sub New()
InitializeComponent()
' Form that has a button on it
AddHandler Button1.PreviewKeyDown, AddressOf Me.button1_PreviewKeyDown
AddHandler Button1.KeyDown, AddressOf Me.button1_KeyDown
Button1.ContextMenuStrip = New ContextMenuStrip
' Add items to ContextMenuStrip
Button1.ContextMenuStrip.Items.Add("One")
Button1.ContextMenuStrip.Items.Add("Two")
Button1.ContextMenuStrip.Items.Add("Three")
End Sub
' By default, KeyDown does not fire for the ARROW keys
Private Sub button1_KeyDown(ByVal sender As Object, ByVal e As KeyEventArgs)
Select Case (e.KeyCode)
Case Keys.Down, Keys.Up
If (Not (Button1.ContextMenuStrip) Is Nothing) Then
Button1.ContextMenuStrip.Show(Button1, _
New Point(0, Button1.Height), ToolStripDropDownDirection.BelowRight)
End If
End Select
End Sub
' PreviewKeyDown is where you preview the key.
' Do not put any logic here, instead use the
' KeyDown event after setting IsInputKey to true.
Private Sub button1_PreviewKeyDown(ByVal sender As Object, ByVal e As PreviewKeyDownEventArgs)
Select Case (e.KeyCode)
Case Keys.Down, Keys.Up
e.IsInputKey = True
End Select
End Sub
End Class
Açıklamalar
SEKME, RETURN, ESC ve ok tuşları gibi bazı tuş basımları, giriş tuşuna basma olarak kabul edilmedikleri için genellikle bazı denetimler tarafından yoksayılır. Örneğin, bir Button denetim varsayılan olarak ok tuşlarını yoksayar. Ok tuşlarına basmak genellikle odağın önceki veya sonraki denetime geçmesine neden olur. Ok tuşları gezinti tuşları olarak kabul edilir ve bu tuşlara basıldığında genellikle için Buttonolay tetiklenmezKeyDown. Ancak, için Button ok tuşlarına basıldığında olay tetikler PreviewKeyDown . için olayını işleyip PreviewKeyDown özelliğini olarak true
ayarlayarakIsInputKey, ok tuşlarına basıldığında olayı tetikleyebilirsinizKeyDown.Button Ancak, ok tuşlarını işlerseniz, odak artık önceki veya sonraki denetime taşınmaz.
Olayları işleme hakkında daha fazla bilgi için bkz. Olayları İşleme ve Oluşturma.