LosingFocusEventArgs.CorrelationId Propiedad

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Input

Obtiene el identificador único generado cuando se inicia un evento de movimiento de foco.

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

winrt::guid CorrelationId();

public Guid CorrelationId { get; }

var guid = losingFocusEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Guid

Valor de propiedad

Guid

Platform::Guid

winrt::guid

Identificador único, si existe; de lo contrario, null. El valor predeterminado es null.

Comentarios

Los movimientos de foco pueden dar lugar a una serie de acciones directas e indirectas.

Por ejemplo, hay la secuencia estándar de eventos que comienza por LosingFocus y se mueve por LostFocus, GettingFocus, a GotFocus. Estos eventos de foco normalmente se enrutan a través de varios elementos del árbol de elementos (incluido focusManager).

En algunos casos, el evento de enfoque también puede volver a enrutarse. Por ejemplo, si el elemento de destino no es válido por algún motivo, puede llamar a TrySetNewFocusedElement desde el evento LosingFocus para volver a dirigir el foco a otro elemento.

En otros casos, es posible que tenga que cancelar un cambio de foco de uno de los controladores de eventos de enfoque.

Además, dado que los eventos de foco se generan de forma asincrónica, el foco podría cambiar de nuevo antes de que un evento de enfoque anterior haya terminado de ejecutarse.

Cada vez que se inicia un evento de enfoque, se genera un único CorrelationId para ayudarle a realizar un seguimiento de un evento de enfoque a lo largo de estas acciones de enfoque.

Se genera un nuevo CorrelationId cuando:

• El usuario mueve el foco.
• La aplicación mueve el foco mediante métodos como UIElement.Focus o FocusManager.TryFocusAsync.
• La aplicación obtiene o pierde el foco debido a la activación de la ventana (consulta Window.Activated).

Consulte también

• CorrelationId