FocusManager.TryFocusAsync(DependencyObject, FocusState) Método

Definição

Namespace:

Windows.UI.Xaml.Input

Tenta de forma assíncrona definir o foco em um elemento quando o aplicativo é inicializado.

public:
 static IAsyncOperation<FocusMovementResult ^> ^ TryFocusAsync(DependencyObject ^ element, FocusState value);

/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<FocusMovementResult> TryFocusAsync(DependencyObject const& element, FocusState const& value);

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<FocusMovementResult> TryFocusAsync(DependencyObject element, FocusState value);

function tryFocusAsync(element, value)

Public Shared Function TryFocusAsync (element As DependencyObject, value As FocusState) As IAsyncOperation(Of FocusMovementResult)

Parâmetros

element

DependencyObject

O objeto no qual definir o foco.

value

FocusState

Um dos valores da enumeração FocusState que especificam como um elemento pode obter o foco.

Retornos

IAsyncOperation<FocusMovementResult>

O FocusMovementResult que indica se o foco foi definido com êxito.

Atributos

RemoteAsyncAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 1803 (introduzida na 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v6.0)

Exemplos

Aqui, mostramos como definir o foco em um objeto WebView e, se isso falhar, restaurar o foco para o elemento original.

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); 
    } 
}

Comentários

Alguns objetos, como um WebView, podem ser executados no processo do aplicativo ou em um processo separado (consulte WebViewExecutionMode.SeparateProcess).

Quando um objeto é executado no processo do aplicativo, os seguintes eventos de foco ocorrem conforme o esperado para o objeto focado anteriormente e o objeto recém-focado:

• GettingFocus
• LosingFocus
• GotFocus
• LostFocus

No entanto, se o objeto recém-focado estiver em execução em um processo separado, alguns desses comportamentos de evento poderão ser diferentes.

• GetFocusedElement não retorna o objeto recém-focado até que a operação TryFocusAsync seja concluída.
• O controle que perde o foco recebe seu evento LosingFocus de forma síncrona, mas não recebe LostFocus até que a operação assíncrona seja concluída.
• O controle que recebe o foco recebe o evento GettingFocus de forma síncrona, mas não recebe GotFocus até que a operação assíncrona seja concluída.

TryFocusAsync é concluído de forma síncrona quando chamado em um elemento em execução no processo do aplicativo.

Confira também

• Interações por teclado
• Navegação por foco para teclado, gamepad, controle remoto e ferramentas de acessibilidade
• Navegação por foco programática