InputPane.Showing イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
入力ウィンドウがビューにスライドし始めると発生します。
// Register
event_token Showing(TypedEventHandler<InputPane, InputPaneVisibilityEventArgs const&> const& handler) const;
// Revoke with event_token
void Showing(event_token const* cookie) const;
// Revoke with event_revoker
InputPane::Showing_revoker Showing(auto_revoke_t, TypedEventHandler<InputPane, InputPaneVisibilityEventArgs const&> const& handler) const;
public event TypedEventHandler<InputPane,InputPaneVisibilityEventArgs> Showing;
function onShowing(eventArgs) { /* Your code */ }
inputPane.addEventListener("showing", onShowing);
inputPane.removeEventListener("showing", onShowing);
- or -
inputPane.onshowing = onShowing;
Public Custom Event Showing As TypedEventHandler(Of InputPane, InputPaneVisibilityEventArgs)
イベントの種類
注釈
システムは、 GetForCurrentView メソッドを呼び出したときに表示されたアプリケーション ウィンドウに入力ウィンドウを関連付けます。 これは、新しい入力ウィンドウ オブジェクトを作成し、新しいウィンドウを作成するたびに Showing イベントに登録する必要があることを意味します。
システムがイベント ハンドラーを呼び出すと、入力ウィンドウが表示にスライドし始めていません。 イベント ハンドラーが戻った後、入力ウィンドウが表示され始めます。 イベント ハンドラーが (200 ミリ秒以内に) 十分に迅速に応答しない場合、入力ウィンドウは、イベント ハンドラーが返されるのを待たずに表示され始めます。
Showing イベントを使用すると、入力ウィンドウが表示されたときにカスタム ユーザー エクスペリエンスを作成できます。 たとえば、インスタント メッセンジャー アプリでは、ユーザーが新しいメッセージを表示するためにスクロールする必要がないように、入力ウィンドウの上に収まるようにチャット ウィンドウと入力ボックスのサイズを変更できます。 カスタム ユーザー エクスペリエンスを作成する場合は、必ずイベント引数に EnsuredFocusedElementInView プロパティを設定して、入力ウィンドウ イベントを処理し、それを試みないことをアプリ フレームワークに通知してください。
複数のアニメーションとコンテンツのサイズ変更が同時に行われる可能性があるため、入力ウィンドウが表示されている間の作業量を最小限に抑える必要があります。 この期間中に実行する作業が多いほど、システム全体のパフォーマンスに影響し、ユーザー エクスペリエンスが低下します。