Keyboard クラス

リファレンス

定義

名前空間:: System.Windows.Input

アセンブリ:: PresentationCore.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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 新しいルーティングイベントとして再公開されます。一般に、およびのUIElement ContentElementアプリケーションのキーボードイベントを処理する方が、イベントを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	要素がキーボードフォーカスを失う過程である場合に発生します。

適用対象

次の方法で共有