Keyboard クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
キーボード デバイスを表します。
public ref class Keyboard abstract sealed
public static class Keyboard
type Keyboard = class
Public Class Keyboard
- 継承
-
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 |
プライマリ キーボード入力デバイスを取得します。 |
メソッド
添付イベント
| GotKeyboardFocus |
要素がキーボード フォーカスを受け取ったときに発生します。 |
| KeyboardInputProviderAcquireFocus |
キーボード入力プロバイダーがフォーカスを取得するときに発生します。 |
| KeyDown |
キーボードのキーが押されると発生します。 |
| KeyUp |
キーボードのキーを離したときに発生します。 |
| LostKeyboardFocus |
要素がキーボード フォーカスを失ったときに発生します。 |
| PreviewGotKeyboardFocus |
要素がキーボード フォーカスを獲得する途中である場合に発生します。 |
| PreviewKeyboardInputProviderAcquireFocus |
キーボード入力プロバイダーがフォーカスを取得中の場合に発生します。 |
| PreviewKeyDown |
キーボードのキーが押されると発生します。 |
| PreviewKeyUp |
キーボードのキーを離したときに発生します。 |
| PreviewLostKeyboardFocus |
要素がキーボード フォーカスを失う過程である場合に発生します。 |