InputPane 類別

  • 參考

定義

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

可讓應用程式在停駐觸控式鍵盤或軟式輸入面板 (SIP) 時接收通知，即將顯示或隱藏，以及判斷應用程式視窗的哪個部分會由輸入窗格遮蔽。

注意

InputPane API 僅提供停駐面板的精確遮蔽資訊。 針對 Windows 10 Creators Fall Update 和更新版本，我們建議使用下列 API 來處理停駐、未停駐、可移動和暫時輸入窗格的遮蔽，例如軟體輸入面板 (SIP) 、輸入法編輯器 (IME) 候選視窗、浮動工具列等等。

public ref class InputPane sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class InputPane final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class InputPane
Public NotInheritable Class InputPane
繼承
Object Platform::Object IInspectable InputPane
屬性
ContractVersionAttribute MarshalingBehaviorAttribute

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

當使用者執行需要輸入資訊的動作時，就會顯示輸入窗格，例如選取文字輸入欄位。 根據預設，Windows 會處理輸入窗格事件並重新置放內容，讓使用者可以看到他們正在輸入的位置。 如果您在應用程式中將 CoreTextEditCoNtext.InputPaneDisplayPolicy 設定為 Manual ，您必須負責使用 TryShow 和 TryHide 來顯示和隱藏輸入窗格。 使用此類別覆寫預設行為，並自訂輸入窗格。

在某些情況下，不支援重迭 UI，例如 InputPane。 這包括：

呼叫 GetForCurrentView 以取得 InputPane 物件。

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

注意

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

版本歷程記錄

Windows 版本 SDK 版本 新增值
1903 18362 GetForUICoNtext

屬性

OccludedRect

取得由輸入窗格遮蔽的應用程式視窗區域。
Visible

取得或設定值，這個值表示是否顯示輸入窗格。

重要

僅適用于 Xbox 裝置系列。

針對通用應用程式， OccludedRect 屬性工作表示輸入窗格所阻礙的應用程式視窗區域。

方法

GetForCurrentView()

取得與目前可見之應用程式視窗相關聯的 InputPane 物件。
GetForUIContext(UIContext)

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

如果可見，嘗試隱藏 InputPane。
TryShow()

如果已隱藏，則會嘗試顯示 InputPane。

這個方法是「最佳」方法，而且保證使用者有方法可以在焦點控制項中輸入文字。 只有硬體鍵盤無法使用時，才會顯示觸控式鍵盤或軟體輸入面板 (SIP) 。

事件

Hiding

當輸入窗格開始滑出檢視時發生。
Showing

當輸入窗格開始滑動至檢視時發生。

適用於

另請參閱