CoreFrameworkInputView 類別

定義

命名空間:

Windows.UI.ViewManagement.Core

提供 UI 架構，能夠在對應的 CoreInputViewPrimaryViewAnimationStarting 和 OcclusionsChanged 事件之後，處理 PrimaryViewAnimationStarting 和 Occlusions Changed 事件。

這可讓架構控制停駐、未停駐、可移動或暫時輸入窗格的顯示（以及相關聯的 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

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 11 (已於 10.0.22000.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v14.0 引進)

備註

架構（例如 XAML）或自定義文字控制項僅使用。

架構可以使用這個物件所公開的信息來調整和重排 UI 以考慮任何遮蔽。

CoreFrameworkInputView API 支援下列類型的輸入窗格。

• 固定的軟輸入面板（SIP），例如 觸控式鍵盤和手寫面板 –通常是您的應用程式 UI 重排。
• 浮動工具列或 SIP – 通常您的應用程式 UI 不會重排。
• 重疊面板，例如內嵌筆跡或輸入法候選視窗 – 通常您的應用程式 UI 不會針對編輯控件重排，但會針對文字/搜尋建議進行重排。

當使用者執行需要他們提供資訊的動作時，會出現輸入窗格，例如輸入文字欄位。

根據預設，Windows 會處理輸入窗格事件並重新定位內容，讓使用者可以看到焦點控件。

呼叫 CoreFrameworkInputView.GetForCurrentView 以取得 CoreFrameworkInputView 物件。

註冊以接收輸入窗格通知之後，系統會在呼叫 CoreFrameworkInputView.GetForCurrentView 方法時，針對前景窗口顯示或隱藏窗格時呼叫事件委派。

注意

這個類別不是敏捷的，這表示您需要考慮其線程模型和封送處理行為。 如需詳細資訊，請參閱 線程和封送處理 （C++/CX）。

方法

GetForCurrentView()	擷取與目前視窗相關聯的 CoreFrameworkInputView 物件。
GetForUIContext(UIContext)	取得與具有指定內容標識碼之檢視相關聯的 CoreFrameworkInputView 物件。

事件

OcclusionsChanged	發生於一或多個 CoreInputViewOcclusion 物件變更其位置或遮蔽區域，以回應與 CoreFrameworkInputView相關聯的輸入窗格重新定位時。
PrimaryViewAnimationStarting	應用程式中發生的動畫，以回應與 coreFrameworkInputView相關聯之輸入窗格的顯示或隱藏。

另請參閱

• CoreInputView