CoreFrameworkInputView クラス

定義

対応する CoreInputView PrimaryViewAnimationStarting および OcclusionsChanged イベントの後に、PrimaryViewAnimationStarting イベントと OcclusionsChanged イベントを処理する機能を UI フレームワークに提供します。

これにより、フレームワークは、ドッキング、ドッキング解除、移動可能、または一時的な入力ウィンドウ (および関連する UI) の表示を制御したり、ウィンドウが移動、表示、非表示になったときに通知を受け取ったり、アプリのウィンドウのどの部分がウィンドウによって隠されるかを判断したりできます。

手記

HoloLens ではサポートされていません。

public ref class CoreFrameworkInputView sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 851968)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CoreFrameworkInputView final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 851968)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CoreFrameworkInputView
Public NotInheritable Class CoreFrameworkInputView
継承
Object Platform::Object IInspectable CoreFrameworkInputView
属性

Windows の要件

デバイス ファミリ
Windows 11 (10.0.22000.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v14.0 で導入)

注釈

フレームワーク (XAML など) またはカスタム テキスト コントロールでのみ使用されます。

フレームワークでは、このオブジェクトによって公開される情報を使用して、任意のオクルージョンを考慮して UI を調整およびリフローできます。

CoreFrameworkInputView API は、次の種類の入力ウィンドウをサポートします。

  • タッチ キーボードや手書きパネル などのドッキングされたソフト入力パネル (SIP) -通常は、アプリの UI がリフローされます。
  • フローティング ツール バーまたは SIP - 通常、アプリ UI はリフローしません。
  • インライン インクや IME 候補ウィンドウなどのオーバーレイ パネル - 通常、アプリ UI は編集コントロールのリフローを行いませんが、テキスト/検索候補のリフローを行います。

入力ウィンドウは、ユーザーがテキスト フィールドの入力などの情報の提供を要求するアクションを実行したときに表示されます。

既定では、Windows は入力ウィンドウ イベントを処理し、ユーザーがフォーカスを持つコントロールを表示できるようにコンテンツの位置を変更します。

CoreFrameworkInputView.GetForCurrentView 呼び出して CoreFrameworkInputView オブジェクトを取得します。

入力ウィンドウ通知を受信するように登録すると、CoreFrameworkInputView.GetForCurrentView メソッドを呼び出したときに、ウィンドウがフォアグラウンド ウィンドウに対して表示または非表示になると、システムによってイベント デリゲートが呼び出されます。

手記

このクラスはアジャイルではありません。つまり、スレッド モデルとマーシャリング動作を考慮する必要があります。 詳細については、「スレッドとマーシャリング (C++/CX)を参照してください。

メソッド

GetForCurrentView()

現在のウィンドウに関連付けられている CoreFrameworkInputView オブジェクトを取得します。

GetForUIContext(UIContext)

指定したコンテキスト識別子を持つビューに関連付けられた CoreFrameworkInputView オブジェクト を取得します。

イベント

OcclusionsChanged

CoreFrameworkInputViewに関連付けられた入力ウィンドウの位置変更に応じて、1 つ以上の CoreInputViewOcclusion オブジェクトが位置または隠れ領域を変更したときに発生します。

PrimaryViewAnimationStarting

CoreFrameworkInputViewに関連付けられた入力ウィンドウの表示または非表示に応答して発生するアプリケーション内のアニメーション。

適用対象

こちらもご覧ください