KeyPressEventArgs.KeyChar KeyPressEventArgs.KeyChar KeyPressEventArgs.KeyChar KeyPressEventArgs.KeyChar Property

Definición

Obtiene o establece el carácter correspondiente a la tecla presionada.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

Valor de propiedad

Carácter ASCII que se crea.The ASCII character that is composed. Por ejemplo, si el usuario presiona MAYÚS + K, esta propiedad devuelve una K mayúscula.For example, if the user presses SHIFT + K, this property returns an uppercase K.

Ejemplos

En el ejemplo siguiente se TextBox crea un control.The following example creates a TextBox control. El keypressed método utiliza la KeyChar propiedad para comprobar si se presionó la tecla entrar.The keypressed method uses the KeyChar property to check whether the ENTER key pressed. Si se presiona la tecla entrar, la Handled propiedad se establece en true, lo que indica que el evento está controlado.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 'Form1

Comentarios

Utilice la KeyChar propiedad para muestrear las pulsaciones de teclas en tiempo de ejecución y modificar las pulsaciones de teclas en circunstancias en tiempo de ejecución especiales.Use the KeyChar property to sample keystrokes at run time and to modify keystrokes under special run-time circumstances. Por ejemplo, puede usar KeyChar para deshabilitar keypresses no numéricos cuando el usuario escribe un código postal, cambiar todos los keypresses alfabéticos a mayúsculas en un campo de entrada de datos o supervisar el teclado u otro dispositivo de entrada de tecla para combinaciones de teclas específicas.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.

Puede obtener o establecer las siguientes claves:You can get or set the following keys:

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

  • CTRL.CTRL.

  • Signos de puntuación.Punctuation marks.

  • Teclas numéricas, tanto en la parte superior del teclado como en el teclado numérico.Number keys, both across the top of the keyboard and on the numeric keypad.

  • ESPECIFICA.ENTER.

No puede obtener o establecer las claves siguientes:You cannot get or set the following keys:

  • Tecla TAB.The TAB key.

  • Insertar y eliminar.INSERT and DELETE.

  • INICIO.HOME.

  • EXTREMO.END.

  • Re Pág y Av Pág.PAGE UP and PAGE DOWN.

  • F1-F2.F1-F2.

  • ALTERNATIVA.ALT.

  • Teclas de dirección.Arrow keys.

Nota

Para obtener información sobre cómo detectar cualquiera de las claves que no son caracteres mencionadas anteriormente, KeyEventArgs vea la clase.For information about how to detect any of the non-character keys mentioned above, see the KeyEventArgs class.

Se aplica a

Consulte también: