KeyPressEventArgs.KeyChar Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta il carattere corrispondente al tasto premuto.

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

Valore della proprietà

Char

Carattere ASCII che viene composto. Quando l'utente preme MAIUSC + K, ad esempio, viene restituita la lettera K in maiuscolo.

Esempio

Nell'esempio seguente viene creato un TextBox controllo. Il keypressed metodo usa la KeyChar proprietà per verificare se il tasto INVIO premuto. Se viene premuto il tasto INVIO, la Handled proprietà è impostata su true, che indica che l'evento viene gestito.

#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 esempi di sequenze di tasti in fase di esecuzione e per modificare le sequenze di tasti in circostanze di runtime speciali. Ad esempio, è possibile usare KeyChar per disabilitare tasti non numerici quando l'utente immette un codice ZIP, modificare tutte le tasti alfabetiche in un campo di immissione dati o monitorare la tastiera o altro dispositivo di input chiave per combinazioni di tasti specifiche.

È possibile ottenere o impostare le chiavi seguenti:

  • a-z, A-Z.

  • CTRL.

  • Punteggiatura.

  • Tasti numerici, sia nella parte superiore della tastiera che nel tastierino numerico.

  • IMMETTERE.

Non è possibile ottenere o impostare le chiavi seguenti:

  • Tasto TAB.

  • INSERT e DELETE.

  • CASA.

  • FINE.

  • PAGINA SU e PAGINA GIÙ.

  • F1-F2.

  • ALT.

  • Tasti di direzione

Nota

Per informazioni su come rilevare una delle chiavi non di carattere indicate in precedenza, vedere la KeyEventArgs classe .

Si applica a

Vedi anche