LosingFocusEventArgs.CorrelationId Свойство

Определение

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

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

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

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).

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

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