FocusManagerGotFocusEventArgs.CorrelationId Propriedade

Definição

Namespace:

Windows.UI.Xaml.Input

Obtém a ID exclusiva gerada quando um evento de movimento de foco é iniciado.

public:
 property Platform::Guid CorrelationId { Platform::Guid get(); };

winrt::guid CorrelationId();

public Guid CorrelationId { get; }

var guid = focusManagerGotFocusEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Guid

Valor da propriedade

Guid

Platform::Guid

winrt::guid

A ID exclusiva, se houver. Caso contrário, nulo.

O padrão é nulo.

Comentários

É recomendável usar os eventos roteados de foco UIElement em vez de eventos FocusManager sempre que possível.

As movimentações de foco podem resultar em várias ações diretas e indiretas.

Por exemplo, há a sequência padrão de eventos que começa com LosingFocus e passa por LostFocus, GettingFocus, para GotFocus. Esses eventos de foco normalmente são roteado por meio de vários elementos na árvore de elementos (incluindo o FocusManager).

Em alguns casos, o evento de foco também pode ser roteado novamente. Por exemplo, se o elemento de destino não for válido por algum motivo, você poderá chamar TrySetNewFocusedElement do evento LosingFocus para redirecionar o foco para outro elemento.

Em outros casos, talvez seja necessário cancelar uma alteração de foco de um dos manipuladores de eventos de foco.

Além disso, como os eventos de foco são gerados de forma assíncrona, o foco pode mudar novamente antes que um evento de foco anterior termine de ser executado.

Cada vez que um evento de foco é iniciado, um CorrelationId exclusivo é gerado para ajudá-lo a acompanhar um evento de foco em todas essas ações de foco.

Uma nova CorrelationId é gerada quando:

• O usuário move o foco.
• O aplicativo move o foco usando métodos como Control.Focus ou FocusManager.TryFocusAsync.
• O aplicativo obtém/perde o foco devido à ativação da janela (consulte CoreWindow.Activated).

Confira também

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