Keyboard 클래스

정의

키보드 디바이스를 나타냅니다.Represents the keyboard device.

public ref class Keyboard abstract sealed
public static class Keyboard
type Keyboard = class
Public Class Keyboard
상속
Keyboard

예제

다음 예제에서는 사용 하는 방법의 IsKeyToggled 키 전환 된 상태에서 인지 확인 하는 방법입니다.The following example shows how to use the IsKeyToggled method to determine if a key is in the toggled state. 경우는 Key 전달할 IsKeyToggled 는 설정/해제할 단추의 배경이 변경 됩니다.If the Key passed to IsKeyToggled is toggled, the background of a button is changed.

// Uses the Keyboard.IsToggled to determine if a key is toggled.
if (Keyboard.IsKeyToggled(Key.Return))
{
    btnIsToggle.Background = Brushes.Red;
}
else
{
    btnIsToggle.Background = Brushes.AliceBlue;
}
' Uses the Keyboard.IsToggled to determine if a key is toggled.
If Keyboard.IsKeyToggled(Key.Return) Then
    btnIsToggle.Background = Brushes.Red
Else
    btnIsToggle.Background = Brushes.AliceBlue
End If

설명

Keyboard 키보드 관련 이벤트, 메서드 및 속성 키보드의 상태에 대 한 정보를 제공 하는 클래스를 제공 합니다.The Keyboard class provides keyboard-related events, methods, and properties that provide information regarding the state of the keyboard.

각 이벤트는 Keyboard 정의 연결된 된 이벤트는 기본 요소 클래스에 의해 다시 노출 UIElementContentElement 새 라우트된 이벤트로 합니다.Each of the events that Keyboard defines as an attached event is also re-exposed by the base element classes UIElement and ContentElement as a new routed event. 일반적으로 것에서 애플리케이션에 대 한 키보드 이벤트를 처리 하는 편리한 UIElementContentElement를 사용 하는 대신는 Keyboard 이벤트입니다.Generally, it is more convenient to handle keyboard events for an application on UIElement and ContentElement, rather than using the Keyboard events. 자세한 내용은 참조 하세요 입력 개요합니다.For details, see Input Overview.

키보드 입력을 수신 하는 요소에 대 한 순서 대로 요소가 포커스를 받을 수 있어야 합니다.In order for an element to receive keyboard input, the element must be focusable. 대부분의 UIElement 파생된 개체는 기본적으로 포커스를 받을 수 있습니다.Most UIElement derived objects are focusable by default. 그렇지 않으면 요소에 포커스를 설정 합니다 Focusable 속성을 기본 요소의 true합니다.Otherwise, to make an element focusable, set the Focusable property on the base element to true. 기본 요소에 대 한 자세한 내용은 참조 하세요. 기본 요소 개요합니다.For more information on the base elements, see Base Elements Overview.

Panel 클래스와 같은 StackPanel 하 고 Canvas의 기본값을 설정 Focusablefalse입니다.Panel classes, such as StackPanel and Canvas, set the default value of Focusable to false. 키보드 포커스를 받으려면 이러한 개체에 대 한 따라서 Focusable 으로 설정 되어 있어야 true합니다.Therefore, for these objects to obtain keyboard focus, Focusable must be set to true.

키보드 포커스는 키보드 입력을 수신 하는 개체를 참조 합니다.Keyboard focus refers to the object that is receiving keyboard input. 키보드 포커스가 있는 요소가 IsKeyboardFocusedtrue합니다.The element with keyboard focus has IsKeyboardFocused set to true. 전체 바탕 화면에 키보드 포커스가 있는 요소가 하나만 있을 수 있습니다.There can be only one element with keyboard focus on the entire desktop. 논리 포커스는 포커스가 있는 포커스 범위 내에서 개체를 가리킵니다.Logical focus refers to the object within a focus scope that has focus. 포커스, 키보드 포커스와 논리 포커스가에 대 한 자세한 내용은 참조 하세요. 입력 개요 하 고 포커스 개요합니다.For more information on focus, keyboard focus, and logical focus, see Input Overview and Focus Overview.

정적 멤버를 Keyboard 주 클래스 대리자 KeyboardDevice 스레드의 호출 되므로 반드시 스레드로부터 안전 하지 않습니다.The static members of the Keyboard class delegate to the primary KeyboardDevice of the calling thread, so they are not necessarily thread-safe.

필드

GotKeyboardFocusEvent

GotKeyboardFocus 연결된 이벤트를 식별합니다.Identifies the GotKeyboardFocus attached event.

KeyboardInputProviderAcquireFocusEvent

KeyboardInputProviderAcquireFocus 연결된 이벤트를 식별합니다.Identifies the KeyboardInputProviderAcquireFocus attached event.

KeyDownEvent

KeyDown 연결된 이벤트를 식별합니다.Identifies the KeyDown attached event.

KeyUpEvent

KeyUp 연결된 이벤트를 식별합니다.Identifies the KeyUp attached event.

LostKeyboardFocusEvent

LostKeyboardFocus 연결된 이벤트를 식별합니다.Identifies the LostKeyboardFocus attached event.

PreviewGotKeyboardFocusEvent

PreviewGotKeyboardFocus 연결된 이벤트를 식별합니다.Identifies the PreviewGotKeyboardFocus attached event.

PreviewKeyboardInputProviderAcquireFocusEvent

PreviewKeyboardInputProviderAcquireFocus 연결된 이벤트를 식별합니다.Identifies the PreviewKeyboardInputProviderAcquireFocus attached event.

PreviewKeyDownEvent

PreviewKeyDown 연결된 이벤트를 식별합니다.Identifies the PreviewKeyDown attached event.

PreviewKeyUpEvent

PreviewKeyUp 연결된 이벤트를 식별합니다.Identifies the PreviewKeyUp attached event.

PreviewLostKeyboardFocusEvent

PreviewLostKeyboardFocus 연결된 이벤트를 식별합니다.Identifies the PreviewLostKeyboardFocus attached event.

속성

DefaultRestoreFocusMode

포커스를 복원할 때 WPF(Windows Presentation Foundation)Windows Presentation Foundation (WPF)의 동작을 가져오거나 설정합니다.Gets or sets the behavior of WPF(Windows Presentation Foundation)Windows Presentation Foundation (WPF) when restoring focus.

FocusedElement

키보드 포커스를 갖는 요소를 가져옵니다.Gets the element that has keyboard focus.

Modifiers

현재 눌러져 있는 ModifierKeys의 집합을 가져옵니다.Gets the set of ModifierKeys that are currently pressed.

PrimaryDevice

기본 키보드 입력 디바이스를 가져옵니다.Gets the primary keyboard input device.

메서드

AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

GotKeyboardFocus 연결된 이벤트에 대한 처리기를 추가합니다.Adds a handler for the GotKeyboardFocus attached event.

AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

KeyboardInputProviderAcquireFocus 연결된 이벤트에 대한 처리기를 추가합니다.Adds a handler for the KeyboardInputProviderAcquireFocus attached event.

AddKeyDownHandler(DependencyObject, KeyEventHandler)

KeyDown 연결된 이벤트에 대한 처리기를 추가합니다.Adds a handler for the KeyDown attached event.

AddKeyUpHandler(DependencyObject, KeyEventHandler)

KeyUp 연결된 이벤트에 대한 처리기를 추가합니다.Adds a handler for the KeyUp attached event.

AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

LostKeyboardFocus 연결된 이벤트에 대한 처리기를 추가합니다.Adds a handler for the LostKeyboardFocus attached event.

AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

PreviewGotKeyboardFocus 연결된 이벤트에 대한 처리기를 추가합니다.Adds a handler for the PreviewGotKeyboardFocus attached event.

AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

PreviewKeyboardInputProviderAcquireFocus 연결된 이벤트에 대한 처리기를 추가합니다.Adds a handler for the PreviewKeyboardInputProviderAcquireFocus attached event.

AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)

PreviewKeyDown 연결된 이벤트에 대한 처리기를 추가합니다.Adds a handler for the PreviewKeyDown attached event.

AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)

PreviewKeyUp 연결된 이벤트에 대한 처리기를 추가합니다.Adds a handler for the PreviewKeyUp attached event.

AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

PreviewLostKeyboardFocus 연결된 이벤트에 대한 처리기를 추가합니다.Adds a handler for the PreviewLostKeyboardFocus attached event.

ClearFocus()

포커스를 지웁니다.Clears focus.

Focus(IInputElement)

지정한 요소에 키보드 포커스를 설정합니다.Sets keyboard focus on the specified element.

GetKeyStates(Key)

지정한 키의 키 상태 집합을 가져옵니다.Gets the set of key states for the specified key.

IsKeyDown(Key)

지정한 키가 눌러져 있는지 여부를 확인합니다.Determines whether the specified key is pressed.

IsKeyToggled(Key)

지정한 키가 전환되었는지 여부를 확인합니다.Determines whether the specified key is toggled.

IsKeyUp(Key)

지정한 키가 놓여 있는지 여부를 확인합니다.Determines whether the specified key is released.

RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

GotKeyboardFocus 연결된 이벤트에 대한 처리기를 제거합니다.Removes a handler for the GotKeyboardFocus attached event.

RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

KeyboardInputProviderAcquireFocus 연결된 이벤트에 대한 처리기를 제거합니다.Removes a handler for the KeyboardInputProviderAcquireFocus attached event.

RemoveKeyDownHandler(DependencyObject, KeyEventHandler)

KeyDown 연결된 이벤트에 대한 처리기를 제거합니다.Removes a handler for the KeyDown attached event.

RemoveKeyUpHandler(DependencyObject, KeyEventHandler)

KeyUp 연결된 이벤트에 대한 처리기를 제거합니다.Removes a handler for the KeyUp attached event.

RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

LostKeyboardFocus 연결된 이벤트에 대한 처리기를 제거합니다.Removes a handler for the LostKeyboardFocus attached event.

RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

PreviewGotKeyboardFocus 연결된 이벤트에 대한 처리기를 제거합니다.Removes a handler for the PreviewGotKeyboardFocus attached event.

RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)

PreviewKeyboardInputProviderAcquireFocus 연결된 이벤트에 대한 처리기를 제거합니다.Removes a handler for the PreviewKeyboardInputProviderAcquireFocus attached event.

RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)

PreviewKeyDown 연결된 이벤트에 대한 처리기를 제거합니다.Removes a handler for the PreviewKeyDown attached event.

RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)

PreviewKeyUp 연결된 이벤트에 대한 처리기를 제거합니다.Removes a handler for the PreviewKeyUp attached event.

RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)

PreviewLostKeyboardFocus 연결된 이벤트에 대한 처리기를 제거합니다.Removes a handler for the PreviewLostKeyboardFocus attached event.

연결된 이벤트

GotKeyboardFocus

요소가 키보드 포커스를 받으면 발생합니다.Occurs when an element receives keyboard focus.

KeyboardInputProviderAcquireFocus

키보드 입력 공급자가 포커스를 가질 때 발생합니다.Occurs when the keyboard input provider acquires focus.

KeyDown

키보드의 키를 누르면 발생합니다.Occurs when a key on the keyboard is pressed.

KeyUp

키보드의 키를 놓을 때 발생합니다.Occurs when a key on the keyboard is released.

LostKeyboardFocus

요소가 키보드 포커스를 잃으면 발생합니다.Occurs when an element loses keyboard focus.

PreviewGotKeyboardFocus

요소가 키보드 포커스를 얻으면 발생합니다.Occurs when an element is in the process of acquiring keyboard focus.

PreviewKeyboardInputProviderAcquireFocus

키보드 입력 공급자가 포커스를 가져오고 있을 때 발생합니다.Occurs when the keyboard input provider is in the process of acquiring focus.

PreviewKeyDown

키보드의 키를 누르면 발생합니다.Occurs when a key on the keyboard is pressed.

PreviewKeyUp

키보드의 키를 놓을 때 발생합니다.Occurs when a key on the keyboard is released.

PreviewLostKeyboardFocus

요소가 키보드 포커스를 잃으면 발생합니다.Occurs when an element is in the process of losing keyboard focus.

적용 대상

추가 정보