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) Тип события
Комментарии
Примечание
Платформа также может вызвать событие в ответ на то, что элемент получает фокус через клавиатуру или игровой контроллер, или когда вспомогательные средства выполняют метод ScrollIntoViewIScrollItemProvider на одноранговом узле автоматизации элемента.
Это событие позволяет элементу управления участвовать в процессе представления элемента. Он указывает родительскому элементу управления, например ScrollViewer, что элемент, вызваввший событие, должен быть видимым в прокручиваемой области. Элементы управления без прокрутки могут использовать событие в качестве способа изменения запросов, поступающих от одного из его дочерних элементов, путем изменения данных события (BringIntoViewRequestedEventArgs). Например, можно прослушивать событие в родительском элементе, чтобы увеличить TargetRect и обеспечить минимальное заполнение при представлении любого из его дочерних элементов.
Как правило, данные события (BringIntoViewRequestedEventArgs) не должны быть помечены как обрабатываемые. Это может помешать целевой цели при вызове StartBringIntoView. Другие данные события могут быть изменены по мере изменения запроса. В частности, родительский элемент управления прокруткой, как ожидается, изменит данные события с учетом его вклада, независимо от того, полностью или частично удовлетворяет запросу. Как минимум, ожидается, что прокрутитель установит себя в качестве TargetElement и обновит TargetRect до собственного координатного пространства. В ситуациях, когда элемент находится внутри прокрутки, который сам находится в прокрутке, каждый из них должен реагировать на соответствие требуемому выравниванию.
OriginalSource следует использовать для определения элемента, для которого изначально было создано событие, учитывая, что TargetElement может быть изменен в виде пузырьков события.
BringIntoViewRequested — это перенаправленное событие. Дополнительные сведения о концепции перенаправленных событий см. в статье Общие сведения о событиях и перенаправленных событиях.