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	获取或设置一个值，该值指示焦点进入文本输入控件时是否应自动显示输入窗格。 默认值为 “自动”，指示将自动显示输入窗格。 值为 Manual 指示应用将负责使用 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	当文本输入服务器需要修改文本输入控件中的文本时发生。 此事件可能是关键事件（例如插入单个字符）的结果，也可以是输入处理器完成的处理结果，例如自动更正和预测。 处理事件时，文本输入控件必须将范围替换为服务器提供的新文本，并将插入点移到新文本的末尾。

另请参阅

• 自定义编辑控件示例