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 |