UIElement.BringIntoViewRequested 事件

  • 參考

定義

命名空間:
Microsoft.UI.Xaml
編輯

在這個專案或其中一個子代上呼叫 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)

事件類型

TypedEventHandler<UIElement,BringIntoViewRequestedEventArgs>

備註

注意

架構也可以引發 事件，以回應透過鍵盤或遊戲控制器接收焦點的專案，或當輔助技術在專案的自動化對等上執行 IScrollItemProvider的 ScrollIntoView 方法時。

此事件可讓控制項參與將專案帶入檢視的程式。 它表示父控制項，例如 ScrollViewer，引發事件的元素應該在可捲動的區域內顯示。 非捲動控制項可以使用 事件，藉由修改 BringIntoViewRequestedEventArgs () ，修改來自其中一個子系的要求。 例如，您可能會在父元素上接聽 事件，以放大 TargetRect ，並確保將任何子項目帶入檢視時，會包含最少的填補量。

一般而言， BringIntoViewRequestedEventArgs () 的事件資料不應該標示為已處理。 這麼做可能會干擾呼叫 StartBringIntoView 時的預期目標。 其他事件資料可能會因為事件反升而改變要求而修改。 具體來說，父捲動控制項應該修改事件資料，以考慮其貢獻，無論是部分或完全滿足要求。 捲動器至少應該將本身設定為 TargetElement ，並將 TargetRect 更新為自己的座標空間。 如果專案位於捲動器內，而捲動器本身位於滾動器內，則每個專案都必須回應以符合要求的對齊方式。

OriginalSource應該用來判斷原本引發事件的元素，因為TargetElement可以修改為事件泡泡。

BringIntoViewRequested 是路由事件。 如需路由事件概念的詳細資訊，請參閱 事件和路由事件概觀。

適用於

另請參閱