共用方式為

CoreFrameworkInputView 類別

  • 參考

定義

命名空間:
Windows.UI.ViewManagement.Core
編輯

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

這可讓架構控制停駐、未停駐、可移動或暫時輸入窗格的顯示， (和相關聯的 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 不會重排。
  • 重迭面板，例如內嵌 Ink 或 IME 候選視窗 – 通常您的應用程式 UI 不會針對編輯控制項重排，但會針對文字/搜尋建議進行重排。

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

根據預設，Windows 會處理輸入窗格事件並重新置放內容，讓使用者可以看到具有焦點的控制項。

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

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

注意

這個類別不是敏捷的，這表示您必須考慮其執行緒模型和封送處理行為。 如需詳細資訊，請參閱 執行緒和封送處理 (C++/CX) 。

方法

GetForCurrentView()

擷取與目前視窗相關聯的 CoreFrameworkInputView 物件。
GetForUIContext(UIContext)

取得與具有指定內容識別碼之檢視相關聯的 CoreFrameworkInputView 物件。

事件

OcclusionsChanged

發生于一或多個 CoreInputViewOcclusion 物件變更其位置或遮蔽區域以回應 與 CoreFrameworkInputView相關聯之輸入窗格的重新置放時。
PrimaryViewAnimationStarting

應用程式中為了回應 CoreFrameworkInputView相關聯之輸入窗格的顯示或隱藏而發生的動畫。

適用於

另請參閱