Lingua

InputFocusController Classe

Definizione

Spazio dei nomi:
Microsoft.UI.Input
Modifica

Rappresenta un oggetto che supporta la gestione e la gestione degli eventi di stato attivo in 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 : InputObject
Public NotInheritable Class InputFocusController
Inherits InputObject
Ereditarietà
Object Platform::Object IInspectable InputObject InputFocusController
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Commenti

ContentIsland ha un HWND sottostante che può interagire con le API Win32 e ricevere messaggi Win32 ,ad esempio vari messaggi di input.

ContentIslandha lo stato attivo se il relativo HWND sottostante ha lo stato attivo su Win32.

Quando un ContentIsland ha lo stato attivo, riceverà messaggi di input da tastiera dal sistema. Gli eventi di input da tastiera possono essere gestiti da un oggetto InputKeyboardSource, recuperato tramite InputKeyboardSource.GetForIsland(Microsoft). UI. Metodo Content.ContentIsland).

Note

Per altri dettagli sullo stato attivo e sull'input della tastiera Win32, vedi la sezione Stato attivo e attivazione della tastiera della panoramica dell'input da tastiera.

Comportamento quando eliminato

InputFocusController è associato a un contentIsland specifico. Se InputFocusController viene eliminato, perde l'associazione e tutti i gestori eventi non vengono registrati.

Se l'oggetto ContentIsland associato viene eliminato, viene eliminato anche l'oggetto InputFocusController associato.

Per altri dettagli, vedere Microsoft. UI. Input.InputObject.

Modello di thread

InputFocusController può essere solo dal thread in cui è stato creato. Qualsiasi chiamata di proprietà o funzione su un thread diverso restituirà RPC_E_WRONG_THREAD (o il tipo di errore proiettato equivalente).

Per altri dettagli, vedere Microsoft. UI. Input.InputObject.

Proprietà

Nome Descrizione
DispatcherQueue

Ottiene dispatcherQueue per InputObject.

(Ereditato da InputObject)
HasFocus

Ottiene un valore che indica se l'oggetto ContentIsland associato ha lo stato attivo.
ShouldShowKeyboardCues

Rappresenta un oggetto che supporta la gestione e la gestione degli eventi di stato attivo in contentIsland.

Metodi

Nome Descrizione
DepartFocus(FocusNavigationRequest)

Genera l'evento InputFocusNavigationHost.DepartFocusRequested per l'host Content.ContentIsland .

Ad esempio, l'utente ha eseguito il tabulazione di tutti gli elementi tabulabili all'interno di ContentIsland e ora lo stato attivo dovrebbe allontanarsi dall'isola a qualcos'altro nell'applicazione host.
GetForIsland(ContentIsland)

Recupera un oggetto InputFocusController per l'oggetto ContentIsland specificato.
TrySetFocus()

Tenta di impostare lo stato attivo su ContentIsland associato a InputFocusController.

Eventi

Nome Descrizione
GotFocus

Si verifica quando l'oggetto ContentIsland associato riceve lo stato attivo.
LostFocus

Si verifica quando lo stato attivo viene spostato dall'oggetto ContentIsland associato.
NavigateFocusRequested

Si verifica quando l'host Content.ContentIsland vuole che ContentIsland prenda lo stato attivo.

Ad esempio, l'utente ha a schede gli elementi dell'host e ora deve eseguire la tabulazioni in ContentIsland. L'applicazione host chiama InputFocusNavigationHost.NavigateFocus(Microsoft. UI. Input.FocusNavigationRequest) in InputFocusNavigationHost associato a SiteBridge. InputFocusController per ContentIsland riceve quindi questo evento NavigateFocusRequested e può decidere se richiede lo stato attivo.

Si applica a

Vedi anche