Keyboard クラス

定義

名前空間:

System.Windows.Input

アセンブリ:

PresentationCore.dll

キーボード デバイスを表します。

public ref class Keyboard abstract sealed

public static class Keyboard

type Keyboard = class

Public Class Keyboard

継承

Object

Keyboard

例

次の例は、 メソッドを IsKeyToggled 使用して、キーが切り替え状態であるかどうかを判断する方法を示しています。 に渡された IsKeyToggled がKey切り替えられると、ボタンの背景が変更されます。

// 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 、キーボード関連のイベント、メソッド、およびキーボードの状態に関する情報を提供するプロパティを提供します。

アタッチされたイベントとして定義される Keyboard 各イベントは、基本要素クラス UIElement によって、および ContentElement 新しいルーティング イベントとして再公開されます。 一般に、 および のUIElementContentElementアプリケーションのキーボード イベントを処理する方が、イベントをKeyboard使用するよりも便利です。 詳細については、「 入力の概要」を参照してください。

要素がキーボード入力を受け取るには、 要素がフォーカス可能である必要があります。 ほとんどの UIElement 派生オブジェクトは、既定でフォーカス可能です。 それ以外の場合、要素をフォーカス可能にするには、基本要素の Focusable プロパティを に true設定します。 基本要素の詳細については、「基本要素の 概要」を参照してください。

Panelや CanvasなどのStackPanelクラスでは、 のFocusable既定値を にfalse設定します。 したがって、これらのオブジェクトがキーボード フォーカスを取得するには、 Focusable を に設定する true必要があります。

キーボード フォーカスは、キーボード入力を受け取っているオブジェクトを指します。 キーボード フォーカスを持つ要素が にtrue設定されていますIsKeyboardFocused。 デスクトップ全体にキーボード フォーカスがある要素は 1 つだけです。 論理フォーカスとは、フォーカスがあるフォーカス スコープ内のオブジェクトを指します。 フォーカス、キーボード フォーカス、論理フォーカスの詳細については、「 入力の概要 」と「 フォーカスの概要」を参照してください。

呼び出し Keyboard 元スレッドのプライマリ KeyboardDevice へのクラス デリゲートの静的メンバー。そのため、必ずしもスレッド セーフであるとは限りません。

フィールド

GotKeyboardFocusEvent	GotKeyboardFocus 添付イベントを識別します。
KeyboardInputProviderAcquireFocusEvent	KeyboardInputProviderAcquireFocus 添付イベントを識別します。
KeyDownEvent	KeyDown 添付イベントを識別します。
KeyUpEvent	KeyUp 添付イベントを識別します。
LostKeyboardFocusEvent	LostKeyboardFocus 添付イベントを識別します。
PreviewGotKeyboardFocusEvent	PreviewGotKeyboardFocus 添付イベントを識別します。
PreviewKeyboardInputProviderAcquireFocusEvent	PreviewKeyboardInputProviderAcquireFocus 添付イベントを識別します。
PreviewKeyDownEvent	PreviewKeyDown 添付イベントを識別します。
PreviewKeyUpEvent	PreviewKeyUp 添付イベントを識別します。
PreviewLostKeyboardFocusEvent	PreviewLostKeyboardFocus 添付イベントを識別します。

プロパティ

DefaultRestoreFocusMode	フォーカスを復元するときのWindows Presentation Foundation (WPF) の動作を取得または設定します。
FocusedElement	キーボード フォーカスを持つ要素を取得します。
Modifiers	現在押されている ModifierKeys のセットを取得します。
PrimaryDevice	プライマリ キーボード入力デバイスを取得します。

メソッド

AddGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	GotKeyboardFocus 添付イベントのハンドラーを追加します。
AddKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	KeyboardInputProviderAcquireFocus 添付イベントのハンドラーを追加します。
AddKeyDownHandler(DependencyObject, KeyEventHandler)	KeyDown 添付イベントのハンドラーを追加します。
AddKeyUpHandler(DependencyObject, KeyEventHandler)	KeyUp 添付イベントのハンドラーを追加します。
AddLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	LostKeyboardFocus 添付イベントのハンドラーを追加します。
AddPreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	PreviewGotKeyboardFocus 添付イベントのハンドラーを追加します。
AddPreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	PreviewKeyboardInputProviderAcquireFocus 添付イベントのハンドラーを追加します。
AddPreviewKeyDownHandler(DependencyObject, KeyEventHandler)	PreviewKeyDown 添付イベントのハンドラーを追加します。
AddPreviewKeyUpHandler(DependencyObject, KeyEventHandler)	PreviewKeyUp 添付イベントのハンドラーを追加します。
AddPreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	PreviewLostKeyboardFocus 添付イベントのハンドラーを追加します。
ClearFocus()	フォーカスをクリアします。
Focus(IInputElement)	指定した要素にキーボード フォーカスを設定します。
GetKeyStates(Key)	指定したキーの状態のセットを取得します。
IsKeyDown(Key)	指定したキーが押されたかどうかを確認します。
IsKeyToggled(Key)	指定したキーが切り替えられたかどうかを確認します。
IsKeyUp(Key)	指定したキーが離されたかどうかを確認します。
RemoveGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	GotKeyboardFocus 添付イベントのハンドラーを削除します。
RemoveKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	KeyboardInputProviderAcquireFocus 添付イベントのハンドラーを削除します。
RemoveKeyDownHandler(DependencyObject, KeyEventHandler)	KeyDown 添付イベントのハンドラーを削除します。
RemoveKeyUpHandler(DependencyObject, KeyEventHandler)	KeyUp 添付イベントのハンドラーを削除します。
RemoveLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	LostKeyboardFocus 添付イベントのハンドラーを削除します。
RemovePreviewGotKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	PreviewGotKeyboardFocus 添付イベントのハンドラーを削除します。
RemovePreviewKeyboardInputProviderAcquireFocusHandler(DependencyObject, KeyboardInputProviderAcquireFocusEventHandler)	PreviewKeyboardInputProviderAcquireFocus 添付イベントのハンドラーを削除します。
RemovePreviewKeyDownHandler(DependencyObject, KeyEventHandler)	PreviewKeyDown 添付イベントのハンドラーを削除します。
RemovePreviewKeyUpHandler(DependencyObject, KeyEventHandler)	PreviewKeyUp 添付イベントのハンドラーを削除します。
RemovePreviewLostKeyboardFocusHandler(DependencyObject, KeyboardFocusChangedEventHandler)	PreviewLostKeyboardFocus 添付イベントのハンドラーを削除します。

添付イベント

GotKeyboardFocus	要素がキーボード フォーカスを受け取ったときに発生します。
KeyboardInputProviderAcquireFocus	キーボード入力プロバイダーがフォーカスを取得するときに発生します。
KeyDown	キーボードのキーが押されると発生します。
KeyUp	キーボードのキーを離したときに発生します。
LostKeyboardFocus	要素がキーボード フォーカスを失ったときに発生します。
PreviewGotKeyboardFocus	要素がキーボード フォーカスを獲得する途中である場合に発生します。
PreviewKeyboardInputProviderAcquireFocus	キーボード入力プロバイダーがフォーカスを取得中の場合に発生します。
PreviewKeyDown	キーボードのキーが押されると発生します。
PreviewKeyUp	キーボードのキーを離したときに発生します。
PreviewLostKeyboardFocus	要素がキーボード フォーカスを失う過程である場合に発生します。

こちらもご覧ください

• KeyboardEventArgs
• KeyEventArgs