KeyPressEventArgs.KeyChar Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtient ou définit le caractère correspondant à la touche activée.

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

Valeur de propriété

Char

Caractère ASCII composé. Par exemple, si l'utilisateur appuie sur les touches Maj + K, cette propriété retourne la lettre K en majuscule.

Exemples

L’exemple suivant crée un TextBox contrôle. La keypressed méthode utilise la KeyChar propriété pour vérifier si la touche Entrée est enfoncée. Si la touche ENTRÉE est enfoncée, la Handled propriété est définie truesur , ce qui indique que l’événement est géré.

#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

Remarques

Utilisez la KeyChar propriété pour échantillonner des séquences de touches au moment de l’exécution et pour modifier les séquences de touches dans des circonstances spéciales d’exécution. Par exemple, vous pouvez utiliser KeyChar pour désactiver les touches non numériques lorsque l’utilisateur entre un code postal, modifier toutes les touches alphabétiques en majuscules dans un champ d’entrée de données, ou surveiller le clavier ou un autre périphérique d’entrée de touche pour des combinaisons de touches spécifiques.

Vous pouvez obtenir ou définir les clés suivantes :

  • a-z, A-Z.

  • CTRL.

  • Ponctuation.

  • Touches numériques, à la fois en haut du clavier et sur le pavé numérique.

  • ENTRER.

Vous ne pouvez pas obtenir ou définir les clés suivantes :

  • Touche Tabulation.

  • INSERT et DELETE.

  • ACCUEIL.

  • FIN.

  • PAGE HAUT et PAGE VERS LE BAS.

  • F1-F2.

  • ALT.

  • Touches de direction.

Notes

Pour plus d’informations sur la façon de détecter l’une des clés autres que des caractères mentionnées ci-dessus, consultez la KeyEventArgs classe.

S’applique à

Voir aussi