CoreTextEditContext 類別

定義

命名空間:

Windows.UI.Text.Core

文字輸入控制項用來與文字輸入伺服器通訊的主要物件。

public ref class CoreTextEditContext sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreTextEditContext final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CoreTextEditContext

Public NotInheritable Class CoreTextEditContext

繼承

Object Platform::Object IInspectable CoreTextEditContext

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 需求

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

備註

若要取得此類型的物件，請呼叫 CoreTextServicesManager.CreateEditCoNtext。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1511	10586	NotifyFocusLeaveCompleted

屬性

InputPaneDisplayPolicy	取得或設定值，指出當焦點進入文字輸入控制項時，是否應該自動顯示輸入窗格。 預設值為 [自動]，表示會自動顯示輸入窗格。 [ 手動 ] 值表示您的應用程式將負責使用 InputPane.TryShow 和 TryHide來顯示和隱藏輸入窗格。
InputScope	取得或設定值，這個值表示文字輸入控制項的輸入範圍。
IsReadOnly	取得或設定值，這個值表示編輯控制項是否可編輯。
Name	取得或設定文字輸入控制項的描述性名稱。 應用程式架構通常會使用 「name」 或 「id」 之類的屬性來識別控制項，因此建議您根據文字輸入伺服器設定此屬性，讓輸入處理器可以更妥善地保留輸入內容，並提供更好的建議。

方法

NotifyFocusEnter()	通知文字輸入伺服器焦點已輸入文字輸入控制項。
NotifyFocusLeave()	通知文字輸入伺服器焦點已離開文字輸入控制項。
NotifyLayoutChanged()	通知文字輸入伺服器文字輸入控制項內的文字配置已變更。
NotifySelectionChanged(CoreTextRange)	通知文字輸入伺服器文字輸入控制項對選取範圍所做的任何變更。 這很重要，以便讓控制項的內部狀態和伺服器的內部狀態保持同步。
NotifyTextChanged(CoreTextRange, Int32, CoreTextRange)	通知文字輸入伺服器文字輸入控制項對文字所做的任何變更。 這很重要，以便讓控制項的內部狀態和伺服器的內部狀態保持同步。 由於對文字的變更也可能會影響選取範圍，因此此方法會採用選取範圍做為參數。

事件

CompositionCompleted	當組合完成時發生。
CompositionStarted	當組合啟動時發生。
FocusRemoved	發生于強制從文字輸入控制項移除焦點時。 應用程式應該處理此事件，以據以移除文字輸入控制項的焦點。
FormatUpdating	發生于文字輸入伺服器需要將不同的格式套用至特定文字範圍時。 這通常會在組合期間發生。
LayoutRequested	發生于文字輸入伺服器需要取得文字範圍和文字輸入控制項本身的周框方塊時。 應用程式應該處理此事件，並傳回要求的幾何資訊。
NotifyFocusLeaveCompleted	發生于焦點離開文字輸入控制項之後。
SelectionRequested	發生于文字輸入伺服器需要取得文字範圍，代表文字輸入控制項中目前選取的文字時。 應用程式應該處理此事件，並傳回所要求的範圍。
SelectionUpdating	發生于文字輸入伺服器需要修改文字輸入控制項中目前選取的文字範圍時。 此事件可能是輸入處理器需要選取某些文字或移動插入號的結果。 文字輸入控制項應該據以設定其選取範圍。
TextRequested	發生于文字輸入伺服器需要從文字輸入控制項取得文字範圍時。 應用程式應該處理此事件，並傳回所要求的範圍。
TextUpdating	發生于文字輸入伺服器需要修改文字輸入控制項內的文字時。 這個事件可能是索引鍵事件的結果，例如插入單一字元，或輸入處理器所完成的處理結果，例如自動校正和預測。 處理事件時，文字輸入控制項必須將範圍取代為伺服器所提供的新文字，並將插入號移到新文字的結尾。

另請參閱

• 自訂編輯控制項範例