UIElement.BringIntoViewRequested Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит при вызове StartBringIntoView для этого элемента или одного из его потомков.
// Register
event_token BringIntoViewRequested(TypedEventHandler<UIElement, BringIntoViewRequestedEventArgs const&> const& handler) const;
// Revoke with event_token
void BringIntoViewRequested(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::BringIntoViewRequested_revoker BringIntoViewRequested(auto_revoke_t, TypedEventHandler<UIElement, BringIntoViewRequestedEventArgs const&> const& handler) const;public event TypedEventHandler<UIElement,BringIntoViewRequestedEventArgs> BringIntoViewRequested;function onBringIntoViewRequested(eventArgs) { /* Your code */ }
uIElement.addEventListener("bringintoviewrequested", onBringIntoViewRequested);
uIElement.removeEventListener("bringintoviewrequested", onBringIntoViewRequested);
- or -
uIElement.onbringintoviewrequested = onBringIntoViewRequested;Public Custom Event BringIntoViewRequested As TypedEventHandler(Of UIElement, BringIntoViewRequestedEventArgs) Тип события
Требования к Windows
| Семейство устройств |
Windows 10, version 1803 (появилось в 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v6.0)
|
Комментарии
Примечание
Платформа также может вызывать событие в ответ на получение фокуса элементом с помощью клавиатуры или геймпада, или когда специальные возможности выполняют метод ScrollIntoViewIScrollItemProvider на одноранговом узле автоматизации элемента.
Это событие позволяет элементу управления участвовать в процессе представления элемента. Он указывает родительскому элементу управления, например ScrollViewer, что элемент, вызваввший событие, должен быть видимым в прокручиваемой области. Элементы управления без прокрутки могут использовать событие как способ изменения запросов, поступающих от одного из его дочерних элементов, путем изменения данных события (BringIntoViewRequestedEventArgs). Например, можно прослушивать событие в родительском элементе, чтобы увеличить TargetRect и обеспечить минимальное заполнение при представлении любого из его дочерних элементов.
Как правило, данные события (BringIntoViewRequestedEventArgs) не должны быть помечены как обрабатываемые. Это может повлиять на предполагаемую цель при вызове StartBringIntoView. Другие данные события могут быть изменены по мере изменения запроса. В частности, ожидается, что родительский элемент управления прокруткой изменит данные события с учетом их вклада, независимо от того, удовлетворяет ли он запросу частично или полностью. Как минимум, ожидается, что прокрутитель установит себя в качестве TargetElement и обновит TargetRect до собственного координатного пространства. В ситуациях, когда элемент находится внутри прокрутки, который сам находится в пределах прокрутки, каждый из них должен реагировать, чтобы удовлетворить запрошенное выравнивание.
OriginalSource следует использовать для определения элемента, для которого изначально было создано событие, учитывая, что TargetElement может быть изменен по мере пузырьков события.
BringIntoViewRequested — это перенаправленное событие. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.