KeyPressEventArgs.KeyChar Proprietà

Definizione

Ottiene o imposta il carattere corrispondente al tasto premuto.Gets or sets the character corresponding to the key pressed.

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

Valore della proprietà

Char

Carattere ASCII che viene composto.The ASCII character that is composed. Quando l'utente preme MAIUSC + K, ad esempio, viene restituita la lettera K in maiuscolo.For example, if the user presses SHIFT + K, this property returns an uppercase K.

Esempio

Nell'esempio seguente viene creato un TextBox controllo.The following example creates a TextBox control. Il keypressed metodo usa la KeyChar proprietà per verificare se il tasto invio è stato premuto.The keypressed method uses the KeyChar property to check whether the ENTER key pressed. Se viene premuto il tasto invio, la Handled proprietà viene impostata su true , che indica che l'evento è gestito.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

Commenti

Utilizzare la KeyChar proprietà per campionare le sequenze di tasti in fase di esecuzione e modificare le sequenze di tasti in circostanze di run-time speciali.Use the KeyChar property to sample keystrokes at run time and to modify keystrokes under special run-time circumstances. Ad esempio, è possibile usare KeyChar per disabilitare i tasti di scelta rapida non numerici quando l'utente immette un codice postale, modificare tutti i tasti alfabetici in lettere maiuscole in un campo di immissione dati oppure monitorare la tastiera o altro dispositivo di input chiave per combinazioni di tasti specifiche.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.

È possibile ottenere o impostare le chiavi seguenti:You can get or set the following keys:

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

  • CTRL.CTRL.

  • Segni di punteggiatura.Punctuation marks.

  • Tasti numerici, sia nella parte superiore della tastiera che nel tastierino numerico.Number keys, both across the top of the keyboard and on the numeric keypad.

  • Entrare.ENTER.

Non è possibile ottenere o impostare le chiavi seguenti:You cannot get or set the following keys:

  • Tasto TAB.The TAB key.

  • INSERT ed DELETE.INSERT and DELETE.

  • Casa.HOME.

  • Fine.END.

  • PGSU e PGGIÙ.PAGE UP and PAGE DOWN.

  • F1-F2.F1-F2.

  • Alt.ALT.

  • Tasti di direzioneArrow keys.

Nota

Per informazioni su come rilevare i codici non carattere indicati in precedenza, vedere la KeyEventArgs classe.For information about how to detect any of the non-character keys mentioned above, see the KeyEventArgs class.

Si applica a

Vedi anche