UIElement.BringIntoViewRequested イベント

定義

名前空間:

Windows.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>

Windows の要件

デバイス ファミリ	Windows 10, version 1803 (10.0.17134.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v6.0 で導入)

注釈

注意

フレームワークでは、キーボードまたはゲームパッドを介してフォーカスを受け取る要素に応答してイベントを発生させたり、支援技術が要素のオートメーション ピアで IScrollItemProvider の ScrollIntoView メソッドを実行したりすることもできます。

このイベントにより、コントロールは要素をビューに取り込むプロセスに参加できます。 ScrollViewer などの親コントロールに対して、イベントを発生させた要素をスクロール可能領域内で表示する必要があることを示します。 スクロールしないコントロールでは、イベント データ (BringIntoViewRequestedEventArgs) を変更することで、その子の 1 つから送信された要求を変更する方法として、 イベントを使用できます。 たとえば、親要素の イベントをリッスンして TargetRect を拡大し、子要素をビューに取り込むときに最小量のパディングが含まれていることを確認できます。

一般に、イベント データ (BringIntoViewRequestedEventArgs) は処理済みとしてマークしないでください。 これを行うと、StartBringIntoView が呼び出されたときに意図した目標に干渉する可能性があります。 要求を変更するためにイベントがバブルアップするにつれて、他のイベント データが変更される場合があります。 具体的には、親スクロール コントロールは、要求を部分的または完全に満たすかどうかに関係なく、その貢献を考慮してイベント データを変更することが期待されます。 少なくとも、スッカーはそれ自体を TargetElement として設定し 、TargetRect を独自の座標空間に更新する必要があります。 要素がスクロールバー内にあり、それ自体がスクロールャー内にある状況では、要求されたアラインメントを満たすために各要素が対応する必要があります。

TargetElement がイベント バブルとして変更される可能性がある場合は、OriginalSource を使用して、イベントが最初に発生した要素を決定する必要があります。

BringIntoViewRequested はルーティング イベントです。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。

こちらもご覧ください

• BringIntoViewRequestedEventArgs
• OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)