iTextSelection 接口 (tom.h)

文本选择是突出显示选定内容的文本范围。

继承

ITextSelection 接口继承自 ITextRange。 ITextSelection 还具有以下类型的成员：

方法

ITextSelection 接口具有这些方法。

ITextSelection：：EndKey 模拟 End 键的功能。
ITextSelection：：GetFlags 获取文本选择标志。
ITextSelection：：GetType 获取文本选择的类型。
ITextSelection：：HomeKey 通用化主页键的功能。
ITextSelection：：MoveDown 模拟向下键和向下翻页键的功能。
ITextSelection：：MoveLeft 通用化向左键的功能。
ITextSelection：：MoveRight 通用化向右键的功能。
ITextSelection：：MoveUp 模拟向上键和向上翻页键的功能。
ITextSelection：：SetFlags 设置文本选择标志。
ITextSelection：：TypeText 键入 bstr 在此选择时提供的字符串，就像有人键入一样。 这类似于基础 SetText 方法，但对 Insert/Overtype 键状态和 UI 设置（如自动更正和智能引号）很敏感。

注解

所选内容与某种视图相关联，并且具有一些面向 UI 的方法，这些方法允许模拟键盘输入。 因此，应用程序可以对文本选择以及 ITextSelection 方法使用 ITextRange 方法。

对于键盘输入仿真，所选内容中使用的范围使用 活动端的概念，这通常是上次移动的末尾。 例如，如果 ITextRange：：Move* 方法对实际上是文本选择的区域进行操作，则最近移动的末尾是活动端。 活动端最熟悉的示例涉及 Shift+箭头键处理，其中活动端是移动端。 因此， ITextSelection 方法包括活动端的移动方法（如 MoveLeft 或 MoveRight），以及用于获取和设置活动结束状态的方法。 这些方法以类似于标准光标键盘操作的方式操作选择。 这样就可以实现宏记录器等功能。

若要查看光标键盘方法的工作原理，请参阅下表。 给定的方法对应于具有 Ctrl 键和 Shift 键的光标键盘键。 通过按或不按 Ctrl 键来选择 Unit 参数，而 扩展 参数是通过按或不按 Shift 键选择的。 请注意， MoveUp 和 MoveDown 对应于多个键盘键。 有关详细信息，请参阅方法的说明。

方法	Cursor-keypad 键	按 ctrl 给定的单位 (未按)	按 SHIFT 提供的扩展 (不按)
EndKey	结束	tomStory (tomLine)	tomExtend (tomMove)
HomeKey	主页	tomStory (tomLine)	tomExtend (tomMove)
MoveLeft	向左键	tomWord (tomCharacter)	tomExtend (tomMove)
MoveRight	向右键	tomWord (tomCharacter)	tomExtend (tomMove)
MoveUp	向上键	tomParagraph (tomLine)	tomExtend (tomMove)
MoveDown	向下键	tomParagraph (tomLine)	tomExtend (tomMove)
MoveUp	Page Up	tomWindow (tomScreen)	tomExtend (tomMove)
MoveDown	Page Down	tomWindow (tomScreen)	tomExtend (tomMove)

 

应用程序通常不实现 ITextSelection 接口。 相反，Microsoft 文本解决方案（如丰富编辑控件）将 ITextSelection 作为其文本对象模型 (TOM) 实现的一部分。

应用程序可以通过调用 GetSelection 方法检索 ITextSelection 指针。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	tom.h