KeyPressEventArgs KeyPressEventArgs KeyPressEventArgs KeyPressEventArgs Class

정의

KeyPress 이벤트에 대한 데이터를 제공합니다.Provides data for the KeyPress event.

public ref class KeyPressEventArgs : EventArgs
[System.Runtime.InteropServices.ComVisible(true)]
public class KeyPressEventArgs : EventArgs
type KeyPressEventArgs = class
    inherit EventArgs
Public Class KeyPressEventArgs
Inherits EventArgs
상속
KeyPressEventArgsKeyPressEventArgsKeyPressEventArgsKeyPressEventArgs
특성

예제

다음 예제를 사용 하는 KeyPressEventArgs 누른 키를 계산 하는 데 키를 누를 때마다 후 결과 표시 합니다.The following example illustrates using the KeyPressEventArgs to count keys as they are pressed and to display the results after each key press. Handled 다음에서 추가 운영 체제를 유지 하려면 true로 설정 키를 처리 합니다.Handled is then set to true to keep the operating system from further processing the key. 가정 된 폼을 TextBox 배치 합니다.The example assumes a form with a TextBox placed on it.

public ref class myKeyPressClass
{
private:
   static long keyPressCount = 0;
   static long backspacePressed = 0;
   static long returnPressed = 0;
   static long escPressed = 0;
   TextBox^ textBox1;
   void myKeyCounter( Object^ sender, KeyPressEventArgs^ ex )
   {
      switch ( ex->KeyChar )
      {
            // Counts the backspaces.
         case '\b':
         backspacePressed = backspacePressed + 1;
         break;

            // Counts the ENTER keys.
         case '\r':
         returnPressed = returnPressed + 1;
         break;

            // Counts the ESC keys.  
         case (char)27:
         escPressed = escPressed + 1;
         break;
            
            // Counts all other keys.
         default:
         keyPressCount = keyPressCount + 1;
         break;
      }
      textBox1->Text = String::Concat( 
         backspacePressed, " backspaces pressed\r\n",
         escPressed, " escapes pressed\r\n",
         returnPressed, " returns pressed\r\n",
         keyPressCount, " other keys pressed\r\n" );
      ex->Handled = true;
   }
};
public class myKeyPressClass 
 {
     static long keyPressCount = 0 ;
     static long backspacePressed =  0;
     static long returnPressed = 0 ;
     static long escPressed = 0 ;
     private TextBox textBox1 = new TextBox();
     private void myKeyCounter(object sender, KeyPressEventArgs ex)
     {
     switch(ex.KeyChar)
     {
             // Counts the backspaces.
         case '\b':
         backspacePressed = backspacePressed + 1;
         break ;
             // Counts the ENTER keys.
         case '\r':
         returnPressed = returnPressed + 1 ;
         break ;
             // Counts the ESC keys.  
         case (char)27:
         escPressed = escPressed + 1 ;
         break ;
             // Counts all other keys.
         default:
         keyPressCount = keyPressCount + 1 ;
         break;
     }
     
     textBox1.Text = 
         backspacePressed + " backspaces pressed\r\n" + 
         escPressed + " escapes pressed\r\n" +
         returnPressed + " returns pressed\r\n" +
         keyPressCount + " other keys pressed\r\n" ;
     ex.Handled = true ;
     }
 }
Public Class myKeyPressClass
    Private Shared keyPressCount As Long = 0
    Private Shared backspacePressed As Long = 0
    Private Shared returnPressed As Long = 0
    Private Shared escPressed As Long = 0
    Private textBox1 As TextBox
    
    Private Sub myKeyCounter(sender As Object, ex As KeyPressEventArgs)
        Select Case ex.KeyChar
            ' Counts the backspaces.
            Case ControlChars.Back
                backspacePressed = backspacePressed + 1
            ' Counts the ENTER keys.
            Case ControlChars.Lf
                returnPressed = returnPressed + 1
            ' Counts the ESC keys.  
            Case Convert.ToChar(27)
                escPressed = escPressed + 1
            ' Counts all other keys.
            Case Else
                keyPressCount = keyPressCount + 1
        End Select
        
        textBox1.Text = backspacePressed & " backspaces pressed" & _
            ControlChars.Lf & ControlChars.Cr & escPressed & _
            " escapes pressed" & ControlChars.CrLf & returnPressed & _
            " returns pressed" & ControlChars.CrLf & keyPressCount & _
            " other keys pressed" & ControlChars.CrLf
        ex.Handled = True
    End Sub
End Class

이 클래스의 새 인스턴스를 만들어야 합니다.You must create a new instance of this class. 또한 이벤트 처리기를 설정 해야 합니다.You must also set the event handler. 클래스의 생성자에서 수행할 수 있습니다.You can do this in the constructor for your class.

public:
   myKeyPressClass^ myKeyPressHandler;

   Form1()
   {
      myKeyPressHandler = gcnew myKeyPressClass;

      InitializeComponent();

      textBox1->KeyPress += gcnew KeyPressEventHandler(
         myKeyPressHandler, &myKeyPressClass::myKeyCounter );
   }
myKeyPressClass myKeyPressHandler = new myKeyPressClass();
public Form1()
{
     InitializeComponent();
 
     textBox1.KeyPress += new KeyPressEventHandler(myKeyPressHandler.myKeyCounter);
}
Private myKeyPressHandler As New myKeyPressClass()

Public Sub New()
    InitializeComponent()
    
    AddHandler textBox1.KeyPress, AddressOf myKeyPressHandler.myKeyCounter
End Sub

컨트롤의 지정 된 이벤트가 발생 하는 경우 연결 된 메서드가 호출 되 고 애플리케이션 이벤트에 대 한 응답에서 코드를 실행할 수 있습니다.When the specified event is raised in the control, the attached method is called and the application can execute code in response to the event.

설명

KeyPressEventArgs 사용자가 키를 누를 때 구성 되는 문자를 지정 합니다.A KeyPressEventArgs specifies the character that is composed when the user presses a key. 예를 들어 사용자가 누르면 SHIFT + K는 KeyChar 속성을 대문자 K를 반환 합니다.For example, when the user presses SHIFT + K, the KeyChar property returns an uppercase K.

KeyPress 이벤트는 사용자가 키를 누를 때 발생 합니다.A KeyPress event occurs when the user presses a key. 밀접 하 게 하는 두 개의 이벤트를 KeyPress 이벤트는 KeyUpKeyDown입니다.Two events that are closely related to the KeyPress event are KeyUp and KeyDown. 합니다 KeyDown 각 이벤트 앞 KeyPress 사용자가 키를 누르면 이벤트 및 KeyUp 이벤트 키를 놓을 때 발생 합니다.The KeyDown event precedes each KeyPress event when the user presses a key, and a KeyUp event occurs when the user releases a key. 키를 누르고 때 중복 KeyDownKeyPress 이벤트 문자 반복 될 때마다 발생 합니다.When the user holds down a key, duplicate KeyDown and KeyPress events occur each time the character repeats. 하나의 KeyUp 릴리스되면 이벤트가 생성 됩니다.One KeyUp event is generated upon release.

상호 KeyPress 이벤트는 KeyPressEventArgs 전달 됩니다.With each KeyPress event, a KeyPressEventArgs is passed. A KeyEventArgs 각 함께 전달 되 면 KeyDownKeyUp 이벤트입니다.A KeyEventArgs is passed with each KeyDown and KeyUp event. KeyEventArgs 보조키 (CTRL, shift 키 또는 ALT) 다른 키와 함께 눌렀는지 여부를 지정 합니다.A KeyEventArgs specifies whether any modifier keys (CTRL, SHIFT, or ALT) were pressed along with another key. (이 한정자 정보를 통해 가져올 수도 있습니다는 ModifierKeys 의 속성을 Control 클래스.)(This modifier information can also be obtained through the ModifierKeys property of the Control class.)

설정 Handledtrue 취소 하는 KeyPress 이벤트입니다.Set Handled to true to cancel the KeyPress event. 이렇게 하면 컨트롤이 키 누름을 처리 합니다.This keeps the control from processing the key press.

참고

일부 컨트롤에 특정 키 입력을 처리할 KeyDown합니다.Some controls will process certain key strokes on KeyDown. 예를 들어 RichTextBox 하기 전에 Enter 키를 처리 KeyPress 라고 합니다.For example, RichTextBox processes the Enter key before KeyPress is called. 이러한 경우에는 취소할 수 없습니다는 KeyPress 이벤트에서 키 입력을 취소 해야 KeyDown 대신 합니다.In such cases, you cannot cancel the KeyPress event, and must cancel the key stroke from KeyDown instead.

이벤트 모델에 대 한 자세한 내용은 이벤트 처리 및 발생합니다.For information about the event model, see Handling and Raising Events.

생성자

KeyPressEventArgs(Char) KeyPressEventArgs(Char) KeyPressEventArgs(Char) KeyPressEventArgs(Char)

KeyPressEventArgs 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the KeyPressEventArgs class.

속성

Handled Handled Handled Handled

KeyPress 이벤트가 처리되었는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the KeyPress event was handled.

KeyChar KeyChar KeyChar KeyChar

누른 키에 해당하는 문자를 가져오거나 설정합니다.Gets or sets the character corresponding to the key pressed.

메서드

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

적용 대상

추가 정보