GettingFocusEventArgs.CorrelationId Свойство

  • Ссылка

Определение

Пространство имен:
Windows.UI.Xaml.Input
Изменить

Возвращает уникальный идентификатор, созданный при инициировании события перемещения фокуса.

public:
 property Platform::Guid CorrelationId { Platform::Guid get(); };
winrt::guid CorrelationId();
public Guid CorrelationId { get; }
var guid = gettingFocusEventArgs.correlationId;
Public ReadOnly Property CorrelationId As Guid

Значение свойства

Guid

Platform::Guid

winrt::guid

Уникальный идентификатор, если таковой есть. В противном случае — null.

Значение по умолчанию — NULL.

Требования к Windows

Семейство устройств
Windows 10, version 1809 (появилось в 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v7.0)

Комментарии

Перемещение фокуса может привести к ряду прямых и косвенных действий.

Например, существует стандартная последовательность событий, которая начинается с LostFocus и перемещается через LostFocus, GettingFocus, в GotFocus. Эти события фокуса обычно направляются через несколько элементов в дереве элементов (включая FocusManager).

В некоторых случаях событие фокуса также может быть перенаправлено повторно. Например, если целевой элемент по какой-либо причине недопустим, можно вызвать TrySetNewFocusedElement из события LosingFocus , чтобы перенацелить фокус на другой элемент.

В других случаях может потребоваться отменить изменение фокуса из одного из обработчиков событий фокуса.

Кроме того, так как события фокуса вызываются асинхронно, фокус может снова измениться до завершения выполнения предыдущего события фокуса.

Каждый раз, когда инициируется событие фокусировки, создается уникальный идентификатор CorrelationId, который помогает отслеживать событие фокусировки во всех этих действиях фокуса.

Новый идентификатор CorrelationId создается в случаях, когда:

  • Пользователь перемещает фокус.
  • Приложение перемещает фокус с помощью таких методов, как Control.Focus или FocusManager.TryFocusAsync.
  • Приложение получает или теряет фокус из-за активации окна (см. CoreWindow.Activated).

Применяется к

См. также раздел