GettingFocusEventArgs.CorrelationId Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает уникальный идентификатор, созданный при инициации события перемещения фокуса.
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Значение свойства
Уникальный идентификатор, если он есть; в противном случае — null. Значение по умолчанию — null.
Комментарии
Перемещение фокуса может привести к ряду прямых и косвенных действий.
Например, существует стандартная последовательность событий, которая начинается с LostFocus и перемещается через LostFocus, GettingFocus, в GotFocus. Эти события фокуса обычно направляются через несколько элементов в дереве элементов (включая FocusManager).
В некоторых случаях событие фокуса также может перенаправиться. Например, если целевой элемент по какой-либо причине недопустим, можно вызвать TrySetNewFocusedElement из события LosingFocus, чтобы перенацелить фокус на другой элемент.
В других случаях может потребоваться отменить изменение фокуса из одного из обработчиков событий фокуса.
Кроме того, так как события фокуса вызываются асинхронно, фокус может снова измениться до завершения выполнения предыдущего события фокуса.
Каждый раз, когда инициируется событие фокусировки, создается уникальный CorrelationId объект, помогающий отслеживать событие фокусировки на протяжении всех этих действий фокуса.
Новый CorrelationId создается, когда:
- Пользователь перемещает фокус.
- Приложение перемещает фокус с помощью таких методов, как UIElement.Focus или FocusManager.TryFocusAsync.
- Приложение получает или теряет фокус из-за активации окна (см . раздел Window.Activated).