KeyboardAccelerator クラス

定義

ユーザーが (直接またはアクセス キーを使用して) アプリ UI を移動するのではなく、キーボードを使用してアクションを実行できるようにするキーボード ショートカット (またはアクセラレータ) を表します。

アクセラレータは通常、ボタンまたはメニュー項目に割り当てられます。

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class KeyboardAccelerator : DependencyObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class KeyboardAccelerator : DependencyObject
Public Class KeyboardAccelerator
Inherits DependencyObject
継承
Object IInspectable DependencyObject KeyboardAccelerator
属性

注釈

アクセラレータ キーには、F1 - F12 や Esc などの 1 つのキー、またはコマンドを呼び出すキーの組み合わせ (Ctrl + Shift + B、または Ctrl C) を指定できます。 これらは、通常 Alt キーで変更され、単にコマンドまたはコントロールをアクティブ化するアクセス キー (ニーモニック) とは異なります。

アクセラレータに関連付けられている要素が表示されない場合でも、アクセラレータを実行できます。 たとえば、CommandBarSecondaryCommands コレクション内の項目は、オーバーフロー メニューを展開して 要素を表示せずにアクセラレータを使用して呼び出すことができます。

既定では、アクセラレータにはグローバル スコープがあります。 ただし、 ScopeOwner を使用してスコープを制限したり、 IsEnabled を使用してアクセラレータを完全に無効にしたりできます。

コンストラクター

KeyboardAccelerator()

KeyboardAccelerator クラスの新しいインスタンスを初期化します。

プロパティ

Dispatcher

常に Windows アプリ SDK アプリで を返しますnull。 代わりに DispatcherQueue を使用してください。

(継承元 DependencyObject)
DispatcherQueue

このオブジェクトが DispatcherQueue 関連付けられている を取得します。 は DispatcherQueue 、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の にアクセス DependencyObject できる機能を表します。

(継承元 DependencyObject)
IsEnabled

ユーザーがキーボード ショートカット (アクセラレータ) を使用できるかどうかを取得または設定します。

IsEnabledProperty

IsEnabled 依存関係プロパティを識別します。

Key

キーボード ショートカット (アクセラレータ) の仮想キー (1 つ以上の修飾子キーと組み合わせて使用) を取得または設定します。

ショートカットに関連付けられている修飾キーが押され、非修飾キーが同時に押されると、キーボード ショートカットが呼び出されます。 たとえば、コピーの場合は Ctrl + C、保存の場合は Ctrl + S です。

KeyProperty

Key 依存関係プロパティを識別します。

Modifiers

キーボード ショートカット (アクセラレータ) の別のキー押しを変更するために使用する仮想キーを取得または設定します。

ショートカットに関連付けられている修飾キーが押され、非修飾キーが同時に押されると、キーボード ショートカットが呼び出されます。 たとえば、コピーの場合は Ctrl + C、保存の場合は Ctrl + S です。

ModifiersProperty

Modifiers 依存関係プロパティを識別します。

ScopeOwner

キーボード アクセラレータのスコープ (またはターゲット) を取得または設定します。

ScopeOwnerProperty

ScopeOwner 依存関係プロパティを識別します。

メソッド

ClearValue(DependencyProperty)

依存関係プロパティのローカル値をクリアします。

(継承元 DependencyObject)
GetAnimationBaseValue(DependencyProperty)

依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。

(継承元 DependencyObject)
GetValue(DependencyProperty)

DependencyObject から依存関係プロパティの現在の有効な値を返します。

(継承元 DependencyObject)
ReadLocalValue(DependencyProperty)

ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。

(継承元 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

この DependencyObject インスタンスの特定の DependencyProperty に対する変更をリッスンするための通知関数を登録します。

(継承元 DependencyObject)
SetValue(DependencyProperty, Object)

DependencyObject の依存関係プロパティのローカル値を設定します。

(継承元 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。

(継承元 DependencyObject)

イベント

Invoked

この KeyboardAccelerator のキーの組み合わせが押されたときに発生します。

適用対象

こちらもご覧ください