GettingFocusEventArgs クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
FocusManager.GettingFocus イベントと UIElement.GettingFocus イベントのデータを提供します。
public ref class GettingFocusEventArgs sealed : RoutedEventArgs/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class GettingFocusEventArgs final : RoutedEventArgs[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class GettingFocusEventArgs : RoutedEventArgsPublic NotInheritable Class GettingFocusEventArgs
Inherits RoutedEventArgs- 継承
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10 Creators Update (10.0.15063.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v4.0 で導入)
|
注釈
フォーカスを設定できるのは、一度に 1 つの UI 要素のみです。
コントロールは、別のコントロールがフォーカスを失ったり、アプリケーション ビューが変更されたり、ユーザーがアプリケーションを切り替えたり、ユーザーがシステムと対話してアプリケーションがフォアグラウンドになくなったりしたときにフォーカスを取得できます。
バージョン履歴
| Windows のバージョン | SDK バージョン | 追加された値 |
|---|---|---|
| 1803 | 17134 | TryCancel |
| 1803 | 17134 | TrySetNewFocusedElement |
| 1809 | 17763 | CorrelationId |
プロパティ
| Cancel |
フォーカス ナビゲーションを取り消す必要があるかどうかを取得または設定します。 |
| CorrelationId |
フォーカス移動イベントが開始されたときに生成される一意の ID を取得します。 |
| Direction |
アプリ UI 内の要素から要素にフォーカスが移動する方向を取得します。 |
| FocusState |
要素がフォーカスを取得する入力モードを取得します。 |
| Handled |
ルーティング イベントを処理済みとしてマークする値を取得または設定します。 Handled の true 値を指定すると、イベント ルートに沿ったほとんどのハンドラーが同じイベントを再び処理できなくなります。 |
| InputDevice |
入力イベントの受信元となる入力デバイスの種類を取得します。 |
| NewFocusedElement |
最新のフォーカスが設定されたオブジェクトを取得します。 |
| OldFocusedElement |
最後にフォーカスされたオブジェクトを取得します。 |
| OriginalSource |
イベントを発生させたオブジェクトへの参照を取得します。 これは多くの場合、アプリ UI で宣言された要素ではなく、コントロールのテンプレート部分です。 (継承元 RoutedEventArgs) |
メソッド
| TryCancel() |
進行中のフォーカス アクションを取り消そうとします。 |
| TrySetNewFocusedElement(DependencyObject) |
元のターゲット要素ではなく、指定した要素にフォーカスをリダイレクトしようとします。 |