KeyEventArgs.KeyCode Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den Tastaturcode für ein KeyDown-Ereignis oder ein KeyUp-Ereignis ab.

public System.Windows.Forms.Keys KeyCode { get; }

Eigenschaftswert

Keys

Ein Keys-Wert, der den Tastencode für das Ereignis darstellt.

Beispiele

Die folgenden Codebeispiele zeigen, wie sie mithilfe der KeyCode -Eigenschaft bestimmen, welche Taste gedrückt wurde.

Beispiel 1

Im folgenden Codebeispiel wird veranschaulicht, wie das KeyDown -Ereignis mit der Help -Klasse verwendet wird, um dem Benutzer der Anwendung hilfe im Popupformat anzuzeigen. Im Beispiel werden die KeyEventArgs an die Ereignishandlermethode übergebenen Eigenschaften verwendet, um nach allen Varianten des Drückens der F1-Taste mit einer Modifizierertaste zu filtern. Wenn der Benutzer eine Variante von F1 drückt, die einen beliebigen Tastaturmodifizierer enthält, zeigt die Help -Klasse ein Popupfenster an, ähnlich einem ToolTip, in der Nähe des Steuerelements. Wenn der Benutzer ALT+F2 drückt, wird ein anderes Hilfe-Popup mit zusätzlichen Informationen angezeigt.

private void textBox1_KeyDown(object sender, System.Windows.Forms.KeyEventArgs e)
{
    // Determine whether the key entered is the F1 key. If it is, display Help.
    if(e.KeyCode == Keys.F1 && (e.Alt || e.Control || e.Shift))
    {
        // Display a pop-up Help topic to assist the user.
        Help.ShowPopup(textBox1, "Enter your name.", new Point(textBox1.Bottom, textBox1.Right));
    }
    else if(e.KeyCode == Keys.F2 && e.Modifiers == Keys.Alt)
    {
        // Display a pop-up Help topic to provide additional assistance to the user.
        Help.ShowPopup(textBox1, "Enter your first name followed by your last name. Middle name is optional.",
            new Point(textBox1.Top, this.textBox1.Left));
    }
}

Beispiel 2

Im folgenden Beispiel wird ermittelt, ob der Benutzer ALT+E gedrückt hat, und wenn sich der Mauszeiger über einem TreeNodebefindet, kann der Benutzer diese TreeNodebearbeiten.

private void treeView1_KeyDown(object sender, KeyEventArgs e)
{
   /* If the 'Alt' and 'E' keys are pressed,
      * allow the user to edit the TreeNode label. */
   if(e.Alt && e.KeyCode == Keys.E)
         
   {
      treeView1.LabelEdit = true;
      // If there is a TreeNode under the mouse cursor, begin editing. 
      TreeNode editNode = treeView1.GetNodeAt(
         treeView1.PointToClient(System.Windows.Forms.Control.MousePosition));
      if(editNode != null)
      { 
         editNode.BeginEdit();
      }
   }
}

private void treeView1_AfterLabelEdit(object sender, NodeLabelEditEventArgs e)
{
   // Disable the ability to edit the TreeNode labels.
   treeView1.LabelEdit = false;
}

Beispiel 3

Im folgenden Beispiel wird ermittelt, ob der Benutzer eine nicht numerische Taste gedrückt hat, und wenn dies der Fall ist, wird das KeyPress Ereignis mithilfe der Handled -Eigenschaft abgebrochen.

// Boolean flag used to determine when a character other than a number is entered.
private bool nonNumberEntered = false;

// Handle the KeyDown event to determine the type of character entered into the control.
private void textBox1_KeyDown(object sender, System.Windows.Forms.KeyEventArgs e)
{
    // Initialize the flag to false.
    nonNumberEntered = false;

    // Determine whether the keystroke is a number from the top of the keyboard.
    if (e.KeyCode < Keys.D0 || e.KeyCode > Keys.D9)
    {
        // Determine whether the keystroke is a number from the keypad.
        if (e.KeyCode < Keys.NumPad0 || e.KeyCode > Keys.NumPad9)
        {
            // Determine whether the keystroke is a backspace.
            if(e.KeyCode != Keys.Back)
            {
                // A non-numerical keystroke was pressed.
                // Set the flag to true and evaluate in KeyPress event.
                nonNumberEntered = true;
            }
        }
    }
    //If shift key was pressed, it's not a number.
    if (Control.ModifierKeys == Keys.Shift) {
        nonNumberEntered = true;
    }
}

// This event occurs after the KeyDown event and can be used to prevent
// characters from entering the control.
private void textBox1_KeyPress(object sender, System.Windows.Forms.KeyPressEventArgs e)
{
    // Check for the flag being set in the KeyDown event.
    if (nonNumberEntered == true)
    {
        // Stop the character from being entered into the control since it is non-numerical.
        e.Handled = true;
    }
}

Gilt für:

Weitere Informationen

• KeyData
• KeyValue