InputFocusController クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ContentIslandでのフォーカス イベントの処理と管理をサポートするオブジェクトを表します。
public ref class InputFocusController sealed : InputObject/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65540)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class InputFocusController final : InputObject[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65540)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class InputFocusController : InputObjectPublic NotInheritable Class InputFocusController
Inherits InputObject- 継承
- 属性
注釈
ContentIsland には、Win32 API と対話し、Win32 メッセージ (さまざまな入力メッセージなど) を受信できる、基になる HWND があります。
基になる HWND に Win32 フォーカスが
ContentIsland にフォーカスがある場合は、システムからキーボード入力メッセージを受信します。 キーボード入力イベントは、InputKeyboardSource オブジェクトによって処理できます。このオブジェクトは、InputKeyboardSource.GetForIsland(Microsoft.UI.Content.ContentIsland) メソッドを使用して取得されます。
手記
Win32 フォーカスとキーボード入力の詳細については、「キーボード入力の概要」の「キーボード フォーカスとアクティブ化の」セクションを参照してください。
破棄された場合の動作
InputFocusController は、特定の ContentIslandに関連付けられています。 InputFocusController が破棄されると、その関連付けが失われ、すべてのイベント ハンドラーが登録解除されます。
関連付けられた ContentIsland が破棄された場合、関連付けられている InputFocusController も破棄されます。
詳細については、Microsoft.UI.Input.InputObject
スレッド モデル
InputFocusController は、作成されたスレッドからのみ使用できます。 別のスレッドでプロパティ アクセスまたは関数呼び出しを行うと、RPC_E_WRONG_THREAD (または同等の予想エラーの種類) が返されます。
詳細については、Microsoft.UI.Input.InputObject
プロパティ
| DispatcherQueue |
InputObject の DispatcherQueue を取得します。 (継承元 InputObject) |
| HasFocus |
関連付けられている ContentIsland にフォーカスがあるかどうかを取得します。 |
メソッド
| DepartFocus(FocusNavigationRequest) |
Content.ContentIsland ホストの InputFocusNavigationHost.DepartFocusRequested イベントを発生させます。 たとえば、ユーザーは ContentIsland 内のすべてのタブ可能な要素をタブで表示し、フォーカスをアイランドからホスティング アプリケーション内の他の要素に移動する必要があります。 |
| GetForIsland(ContentIsland) |
指定した ContentIslandの InputFocusController オブジェクトを取得します。 |
| TrySetFocus() |
InputFocusController に関連付けられている ContentIsland にフォーカスを設定しようとします。 |
イベント
| GotFocus |
関連付けられた ContentIsland がフォーカスを受け取ったときに発生します。 |
| LostFocus |
関連付けられている ContentIslandからフォーカスが移動されたときに発生します。 |
| NavigateFocusRequested |
Content.ContentIsland ホストが ContentIsland にフォーカスを置く必要があるときに発生します。 たとえば、ユーザーはホストの要素をタブ表示し、ContentIsland にタブを移動する必要があります。 ホスティング アプリケーションは、 |