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) を変更することで、その子の 1 つから送信された要求を変更する方法として イベントを使用できます。 たとえば、親要素のイベントをリッスンして TargetRect を拡大し、子要素を表示するときに最小量のパディングが含まれていることを確認できます。

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

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

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

適用対象

こちらもご覧ください