Condividi tramite

FocusManager.TryMoveFocusAsync Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Xaml.Input

Overload

TryMoveFocusAsync(FocusNavigationDirection)

Tenta in modo asincrono di modificare lo stato attivo dall'elemento corrente con lo stato attivo all'elemento attivabile successivo nella direzione specificata.
TryMoveFocusAsync(FocusNavigationDirection, FindNextElementOptions)

Tenta in modo asincrono di modificare lo stato attivo dall'elemento corrente con stato attivo all'elemento attivabile successivo nella direzione specificata e soggetto alle opzioni di spostamento specificate.

TryMoveFocusAsync(FocusNavigationDirection)

Modifica

Tenta in modo asincrono di modificare lo stato attivo dall'elemento corrente con lo stato attivo all'elemento attivabile successivo nella direzione specificata.

public:
 static IAsyncOperation<FocusMovementResult ^> ^ TryMoveFocusAsync(FocusNavigationDirection focusNavigationDirection);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocusAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<FocusMovementResult> TryMoveFocusAsync(FocusNavigationDirection const& focusNavigationDirection);
[Windows.Foundation.Metadata.Overload("TryMoveFocusAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<FocusMovementResult> TryMoveFocusAsync(FocusNavigationDirection focusNavigationDirection);
function tryMoveFocusAsync(focusNavigationDirection)
Public Shared Function TryMoveFocusAsync (focusNavigationDirection As FocusNavigationDirection) As IAsyncOperation(Of FocusMovementResult)

Parametri

focusNavigationDirection
FocusNavigationDirection

La direzione in cui lo stato attivo passa dall'elemento all'elemento all'interno dell'interfaccia utente dell'app.

Restituisce

IAsyncOperation<FocusMovementResult>

FocusMovementResult che indica se lo stato attivo è stato impostato correttamente.

Attributi
OverloadAttribute RemoteAsyncAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v6.0)

Esempio

In questo esempio viene illustrato come impostare lo stato attivo su un oggetto WebView e, in caso di errore, ripristinare lo stato attivo sull'elemento originale.

async void MoveFocus(WebView webView)) 
{ 
    FocusMovementResult result; 
    result = await FocusManager.TryFocusAsync(webView, FocusState.Programmatic); 
    if (!result.Succeeded) 
    { 
        // Restore focus to original element. 
        this.Focus(FocusState.Programmatic); 
    } 
}

Commenti

TryFocusAsync viene completato in modo sincrono quando viene chiamato su un elemento in esecuzione nel processo dell'app.

È anche possibile utilizzare il metodo FindNextElement(FocusNavigationDirection, FindNextElementOptions) o il metodo FindNextElement(FocusNavigationDirection) per spostare lo stato attivo a livello di codice. Questi metodi recuperano l'elemento (come DependencyObject) che riceverà lo stato attivo in base alla direzione di navigazione specificata (solo navigazione direzionale, non può essere utilizzata per emulare lo spostamento tramite tabulazione).

Nota

È consigliabile utilizzare il metodo FindNextElement anziché FindNextFocusableElement perché FindNextFocusableElement recupera un OGGETTO UIElement, che restituisce Null se l'elemento attivabile successivo non è un OGGETTO UIElement, ad esempio un oggetto Hyperlink .

Vedi anche

Si applica a

TryMoveFocusAsync(FocusNavigationDirection, FindNextElementOptions)

Modifica

Tenta in modo asincrono di modificare lo stato attivo dall'elemento corrente con stato attivo all'elemento attivabile successivo nella direzione specificata e soggetto alle opzioni di spostamento specificate.

public:
 static IAsyncOperation<FocusMovementResult ^> ^ TryMoveFocusAsync(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions ^ focusNavigationOptions);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<FocusMovementResult> TryMoveFocusAsync(FocusNavigationDirection const& focusNavigationDirection, FindNextElementOptions const& focusNavigationOptions);
[Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<FocusMovementResult> TryMoveFocusAsync(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions focusNavigationOptions);
function tryMoveFocusAsync(focusNavigationDirection, focusNavigationOptions)
Public Shared Function TryMoveFocusAsync (focusNavigationDirection As FocusNavigationDirection, focusNavigationOptions As FindNextElementOptions) As IAsyncOperation(Of FocusMovementResult)

Parametri

focusNavigationDirection
FocusNavigationDirection

La direzione in cui lo stato attivo passa dall'elemento all'elemento all'interno dell'interfaccia utente dell'app.

focusNavigationOptions
FindNextElementOptions

Opzioni di spostamento utilizzate per identificare il candidato dello stato attivo.

Restituisce

IAsyncOperation<FocusMovementResult>

FocusMovementResult che indica se lo stato attivo è stato impostato correttamente.

Attributi
OverloadAttribute RemoteAsyncAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v6.0)

Esempio

In questo esempio viene illustrato come impostare lo stato attivo su un oggetto WebView e, in caso di errore, ripristinare lo stato attivo sull'elemento originale.

async void MoveFocus(WebView webView)) 
{ 
    FocusMovementResult result; 
    result = await FocusManager.TryFocusAsync(webView, FocusState.Programmatic); 
    if (!result.Succeeded) 
    { 
        // Restore focus to original element. 
        this.Focus(FocusState.Programmatic); 
    } 
}

Commenti

TryFocusAsync viene completato in modo sincrono quando viene chiamato su un elemento in esecuzione nel processo dell'app.

È anche possibile utilizzare il metodo FindNextElement(FocusNavigationDirection, FindNextElementOptions) o il metodo FindNextElement(FocusNavigationDirection) per spostare lo stato attivo a livello di codice. Questi metodi recuperano l'elemento (come DependencyObject) che riceverà lo stato attivo in base alla direzione di navigazione specificata (solo navigazione direzionale, non può essere utilizzata per emulare lo spostamento tramite tabulazione).

Nota

È consigliabile utilizzare il metodo FindNextElement anziché FindNextFocusableElement perché FindNextFocusableElement recupera un OGGETTO UIElement, che restituisce Null se l'elemento attivabile successivo non è un OGGETTO UIElement, ad esempio un oggetto Hyperlink .

Vedi anche

Si applica a