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