키보드 이벤트 사용

대부분의 Windows Forms 프로그램은 키보드 이벤트를 사용하여 키보드 입력을 처리합니다. 이 항목에서는 키보드 이벤트를 대략적으로 설명하고 각 이벤트를 사용하는 경우와 각 이벤트에 제공되는 데이터에 대한 세부 정보를 제공합니다. 자세한 내용은 다음을 참조하십시오. 이벤트 개요(Windows Forms)이벤트 처리기 개요(Windows Forms)이벤트 처리기 개요(Windows Forms)이벤트 개요(Windows Forms)이벤트 처리기 개요(Windows Forms)이벤트 개요(Windows Forms)이벤트 처리기 개요(Windows Forms)이벤트 개요(Windows Forms).

키보드 이벤트

Windows Forms에서는 다음과 같이 사용자가 키보드 키를 누를 때 발생하는 두 가지 이벤트와 사용자가 키보드 키를 놓을 때 발생하는 한 가지 이벤트를 제공합니다.

  • 한 번 발생하는 KeyDown 이벤트

  • 사용자가 동일한 키를 누르고 있을 때 여러 번 발생할 수 있는 KeyPress 이벤트

  • 사용자가 키를 놓을 때 한 번 발생하는 KeyUp 이벤트

사용자가 키를 누르면 Windows Forms에서는 키보드 메시지가 문자 키를 지정하는지, 아니면 실제 키를 지정하는지 여부에 따라 발생시킬 이벤트를 결정합니다. 문자 키 및 실제 키에 대한 자세한 내용은 키보드 입력 작동 방식을 참조하십시오.

다음 표에서는 세 가지 키보드 이벤트에 대해 설명합니다.

키보드 이벤트

설명

결과

KeyDown

이 이벤트는 사용자가 실제 키를 누를 때 발생합니다.

KeyDown에 대한 처리기는 다음 매개 변수를 받습니다.

  • 다음 속성을 제공하는 KeyCode 매개 변수: 실제 키보드 단추를 지정하는 KeyEventArgs 속성

  • Modifiers 속성(Shift, Ctrl, Alt)

  • 키 코드와 한정자를 결합하는 KeyData 속성. 또한 KeyEventArgs 매개 변수는 다음 속성을 제공합니다.

    • 기본 컨트롤이 키를 받지 못하게 설정할 수 있는 Handled 속성

    • 해당 키 입력에 대한 KeyPressKeyUp 이벤트를 표시하지 않기 위한 SuppressKeyPress 속성

KeyPress

이 이벤트는 누른 키가 문자가 될 때 발생합니다. 예를 들어, 사용자가 Shift 키와 소문자 "a" 키를 누르면 대문자 "A"가 됩니다.

KeyDown이 발생한 후 KeyPress가 발생합니다.

  • KeyPress에 대한 처리기는 다음 매개 변수를 받습니다.

  • 누른 키의 문자 코드를 포함하는 KeyPressEventArgs 매개 변수. 이 문자 코드는 문자 키와 한정자 키의 모든 조합에 대해 고유합니다.

    예를 들어, "A" 키는 다음을 생성합니다.

    • Shift 키 또는 Caps Lock 키와 함께 누른 경우 문자 코드 65

    • 해당 문자만 누른 경우 97

    • Ctrl 키와 함께 누른 경우 1

KeyUp

이 이벤트는 사용자가 실제 키를 놓을 때 발생합니다.

KeyUp에 대한 처리기는 다음 매개 변수를 받습니다.

  • 다음 속성을 제공하는 KeyEventArgs 매개 변수

    • 실제 키보드 단추를 지정하는 KeyCode 속성

    • Modifiers 속성(Shift, Ctrl, Alt)

    • 키 코드와 한정자를 결합하는 KeyData 속성

참고 항목

개념

키보드 입력 작동 방식

기타 리소스

Windows Forms 응용 프로그램의 키보드 입력

Windows Forms 응용 프로그램의 마우스 입력