IUIAutomationTextRange 接口 (uiautomationclient.h)

提供对支持 IUIAutomationTextPattern 接口的容器中连续文本范围的访问。 客户端应用程序可以使用 IUIAutomationTextRange 接口从文本范围中选择、比较和检索嵌入的对象。 接口使用两个终结点来分隔文本范围开始和结束的位置。 非连续文本跨度由 IUIAutomationTextRangeArray 接口表示。

继承

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

方法

IUIAutomationTextRange 接口具有这些方法。

IUIAutomationTextRange：：AddToSelection 将文本范围添加到控件中的选定文本范围的集合，该控件支持多个不连续的选定文本范围。 (IUIAutomationTextRange.AddToSelection)
IUIAutomationTextRange：：Clone 检索与原始相同的新 IUIAutomationTextRange，并继承原始的所有属性。
IUIAutomationTextRange：：Compare 检索一个值，该值指定此文本范围是否具有与另一个文本范围相同的终结点。 (IUIAutomationTextRange.Compare)
IUIAutomationTextRange：：CompareEndpoints 检索一个值，该值指定此文本范围的开始或结束终结点是否与另一个文本范围的开始或结束终结点相同。
IUIAutomationTextRange：：ExpandToEnclosingUnit 按指定的文本单位规范化文本范围。 如果范围小于指定的单位，则扩展;如果范围长于指定单位，则缩短范围。 (IUIAutomationTextRange.ExpandToEnclosingUnit)
IUIAutomationTextRange：：FindAttribute 检索具有指定文本属性值的文本范围子集。
IUIAutomationTextRange：：FindText 检索包含指定文本的文本范围子集。
IUIAutomationTextRange：：GetAttributeValue 检索整个文本区域中指定文本属性的值。
IUIAutomationTextRange：：GetBoundingRectangles 检索由文本范围中每个完全或部分可见的文本行的边框组成的集合。 (IUIAutomationTextRange.GetBoundingRectangles)
IUIAutomationTextRange：：GetChildren 检索文本范围内的所有嵌入对象的集合。 (IUIAutomationTextRange.GetChildren)
IUIAutomationTextRange：：GetEnclosingElement 返回包含文本范围的最内部 UI 自动化元素。
IUIAutomationTextRange：：GetText 返回文本范围的纯文本。
IUIAutomationTextRange：：Move 按指定的文本单位数 向前或向后移动文本范围。
IUIAutomationTextRange：：MoveEndpointByRange 将当前文本范围的一个终结点移到第二个文本范围的指定终结点。 (IUIAutomationTextRange.MoveEndpointByRange)
IUIAutomationTextRange：：MoveEndpointByUnit 在文档范围内将文本范围的一个端点移动指定数量的文本单位。
IUIAutomationTextRange：：RemoveFromSelection 从支持多个不连续选择的文本容器中所选文本的现有集合中删除文本范围。
IUIAutomationTextRange：：ScrollIntoView 使文本控件滚动，直到文本范围在视区中可见。
IUIAutomationTextRange：：Select 选择与此文本范围相对应的文本范围，并删除之前所做的任何选择。 (IUIAutomationTextRange.Select)

要求

最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新、带 SP3 的 Windows XP 和适用于 Windows Vista 的平台更新 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2、带 SP2 的 Windows Server 2008 和适用于 Windows Server 2008 的平台更新、带 SP2 的 Windows Server 2003 和适用于 Windows Server 2008 的平台更新 [仅限桌面应用]
目标平台	Windows
标头	uiautomationclient.h (包括 UIAutomation.h)

另请参阅

客户端的控制模式接口

UI 自动化对文本内容的支持

使用文本范围