KeyPressEventArgs.KeyChar Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft das Zeichen ab, das der gedrückten Taste entspricht, oder legt dieses fest.

public:
 property char KeyChar { char get(); };
public:
 property char KeyChar { char get(); void set(char value); };
public char KeyChar { get; }
public char KeyChar { get; set; }
member this.KeyChar : char
member this.KeyChar : char with get, set
Public ReadOnly Property KeyChar As Char
Public Property KeyChar As Char

Eigenschaftswert

Char

Das resultierende ASCII-Zeichen. Wenn der Benutzer beispielsweise UMSCHALT+K drückt, gibt diese Eigenschaft ein großes K zurück.

Beispiele

Im folgenden Beispiel wird ein TextBox Steuerelement erstellt. Die keypressed Methode verwendet die KeyChar Eigenschaft, um zu überprüfen, ob die EINGABETASTE gedrückt wurde. Wenn die EINGABETASTE gedrückt wird, wird die Handled Eigenschaft auf true", die angibt, dass das Ereignis behandelt wird, festgelegt.

#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 Tastenanschläge zur Laufzeit zu beispielen und Tastenanschläge unter speziellen Laufzeitbedingungen zu ändern. Sie können KeyChar beispielsweise verwenden, um nicht numerische Tastenpressen zu deaktivieren, wenn der Benutzer eine Postleitzahl eingibt, alle alphabetischen Tastenpressen in Großbuchstaben in einem Dateneingabefeld ändern oder die Tastatur oder ein anderes Tasteneingabegerät für bestimmte Tastenkombinationen überwachen.

Sie können die folgenden Tasten abrufen oder festlegen:

  • a-z, A-Z.

  • STRG.

  • Interpunktionszeichen.

  • Zahlentasten, sowohl am oberen Rand der Tastatur als auch auf der numerischen Tastatur.

  • EINGEBEN.

Sie können die folgenden Schlüssel nicht abrufen oder festlegen:

  • TAB-TASTE

  • EINFÜGEN und LÖSCHEN.

  • STARTSEITE.

  • ENDE.

  • BILD-NACH-OBEN und BILD-NACH-UNTEN

  • F1-F2.

  • ALT.

  • Pfeiltasten.

Hinweis

Informationen zum Erkennen einer der oben genannten Nichtzeichenschlüssel finden Sie in der KeyEventArgs Klasse.

Gilt für

Siehe auch