KeyPressEventArgs.KeyChar Eigenschaft

Definition

Ruft das Zeichen ab, das der gedrückten Taste entspricht, oder legt dieses fest.Gets or sets the character corresponding to the key pressed.

public:
 property char KeyChar { char get(); };
public char KeyChar { get; }
member this.KeyChar : char
Public ReadOnly Property KeyChar As Char

Eigenschaftswert

Das resultierende ASCII-Zeichen.The ASCII character that is composed. Wenn der Benutzer beispielsweise UMSCHALT+K drückt, gibt diese Eigenschaft ein großes K zurück.For example, if the user presses SHIFT + K, this property returns an uppercase K.

Beispiele

Im folgenden Beispiel wird ein TextBox-Steuerelement erstellt.The following example creates a TextBox control. Die keypressed-Methode verwendet die KeyChar-Eigenschaft, um zu überprüfen, ob die EINGABETASTE gedrückt wurde.The keypressed method uses the KeyChar property to check whether the ENTER key pressed. Wenn die EINGABETASTE gedrückt wird, wird die Handled-Eigenschaft auf truefestgelegt, was darauf hinweist, dass das Ereignis behandelt wird.If the ENTER key is pressed, the Handled property is set to true, which indicates the event is handled.

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;

public ref class Form1: public Form
{
public:
   Form1()
   {
      // Create a TextBox control.
      TextBox^ tb = gcnew TextBox;
      this->Controls->Add( tb );
      tb->KeyPress += gcnew KeyPressEventHandler( this, &Form1::keypressed );
   }

private:
   void keypressed( Object^ /*o*/, KeyPressEventArgs^ e )
   {
      // The keypressed method uses the KeyChar property to check 
      // whether the ENTER key is pressed. 
      // If the ENTER key is pressed, the Handled property is set to true, 
      // to indicate the event is handled.
      if ( e->KeyChar == (char)13 )
            e->Handled = true;
   }
};

int main()
{
   Application::Run( gcnew Form1 );
}

using System;
using System.Windows.Forms;

public class Form1: Form
{
    public Form1()
    {
        // Create a TextBox control.
        TextBox tb = new TextBox();
        this.Controls.Add(tb);
        tb.KeyPress += new KeyPressEventHandler(keypressed);
    }

    private void keypressed(Object o, KeyPressEventArgs e)
    {
        // The keypressed method uses the KeyChar property to check 
        // whether the ENTER key is pressed. 

        // If the ENTER key is pressed, the Handled property is set to true, 
        // to indicate the event is handled.
        if (e.KeyChar == (char)Keys.Return)
        {
            e.Handled = true;
        }
    }

    public static void Main()
    {
        Application.Run(new Form1());
    }
}
Imports System.Windows.Forms

Public Class Form1
    Inherits Form

    Public Sub New()
        ' Create a TextBox control.
        Dim tb As New TextBox()
        Me.Controls.Add(tb)
        AddHandler tb.KeyPress, AddressOf keypressed
    End Sub

    Private Sub keypressed(ByVal o As [Object], ByVal e As KeyPressEventArgs)
        ' The keypressed method uses the KeyChar property to check 
        ' whether the ENTER key is pressed. 

        ' If the ENTER key is pressed, the Handled property is set to true, 
        ' to indicate the event is handled.

        If e.KeyChar = Microsoft.VisualBasic.ChrW(Keys.Return) Then
            e.Handled = True
        End If
    End Sub

    Public Shared Sub Main()
        Application.Run(New Form1())
    End Sub
End Class

Hinweise

Verwenden Sie die KeyChar-Eigenschaft, um zur Laufzeit Stichproben von Tastatureingaben auszuführen und Tastatureingaben unter speziellen Lauf Zeit Bedingungen zu ändern.Use the KeyChar property to sample keystrokes at run time and to modify keystrokes under special run-time circumstances. Beispielsweise können Sie KeyChar verwenden, um nicht numerische Tastatureingaben zu deaktivieren, wenn der Benutzer eine Postleitzahl eingibt, alle alphabetischen keypressen in Großbuchstaben in einem Dateneingabefeld ändern oder das Tastatur-oder andere Schlüsseleingabe Gerät für bestimmte Tastenkombinationen überwachen.For example, you can use KeyChar to disable non-numeric keypresses when the user enters a ZIP code, change all alphabetical keypresses to uppercase in a data entry field, or monitor the keyboard or other key input device for specific key combinations.

Sie können die folgenden Schlüssel erhalten oder festlegen:You can get or set the following keys:

  • a-z, a-z.a-z, A-Z.

  • Drücken.CTRL.

  • Interpunktions Zeichen.Punctuation marks.

  • Zahlenschlüssel, sowohl über dem oberen Rand der Tastatur als auch auf der numerischen Tastatur.Number keys, both across the top of the keyboard and on the numeric keypad.

  • Eingehen.ENTER.

Die folgenden Schlüssel können nicht festgelegt oder festgelegt werden:You cannot get or set the following keys:

  • TAB-TASTEThe TAB key.

  • Einfügen und löschen.INSERT and DELETE.

  • Traum.HOME.

  • Schließlich.END.

  • Bild-auf und Bild-ab.PAGE UP and PAGE DOWN.

  • F1-F2.F1-F2.

  • ALT.ALT.

  • Pfeiltasten.Arrow keys.

Hinweis

Informationen dazu, wie Sie die oben erwähnten nicht-Zeichen Schlüssel erkennen, finden Sie in der KeyEventArgs-Klasse.For information about how to detect any of the non-character keys mentioned above, see the KeyEventArgs class.

Gilt für:

Siehe auch