ITextRangeProvider 接口

定义

命名空间:

Windows.UI.Xaml.Automation.Provider

公开方法和属性，以支持 Microsoft UI 自动化客户端访问实现 ITextProvider 的文本容器中的连续文本范围。

public interface class ITextRangeProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(41183373, 1769, 20326, 148, 70, 40, 165, 190, 152, 251, 208)]
struct ITextRangeProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(41183373, 1769, 20326, 148, 70, 40, 165, 190, 152, 251, 208)]
public interface ITextRangeProvider

Public Interface ITextRangeProvider

派生

Windows.UI.Xaml.Automation.Provider.ITextRangeProvider2

属性

ContractVersionAttribute GuidAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

有关此模式的详细信息，请参阅 Text 和 TextRange 控件模式。

使用此接口定义的任何现有Windows 运行时自动化对等方都不实现 ITextProvider、ITextProvider2 和 ITextRangeProvider。 Windows 运行时文本控件（如 TextBox 和 RichTextBlock）支持的文本模型确实实现了其中一些模式，但在 API 图面的Windows 运行时定义中未显示的本机级别执行此操作。 有关详细信息，请参阅各种Windows 运行时文本控件的对等类。

ITextRangeProvider 模式没有Windows 运行时属性标识符类。

方法

AddToSelection()	将 添加到支持多个不连续选择的文本容器中突出显示的文本集合。
Clone()	返回一个新的 ITextRangeProvider， 它与原始 ITextRangeProvider 相同，并继承原始的所有属性。
Compare(ITextRangeProvider)	返回一个值，该值指示文本范围的起点和终点是否与另一个文本范围相同。
CompareEndpoints(TextPatternRangeEndpoint, ITextRangeProvider, TextPatternRangeEndpoint)	返回一个值，该值指示两个文本范围是否具有相同的终结点。
ExpandToEnclosingUnit(TextUnit)	将文本范围扩展到指定的文本单位。
FindAttribute(Int32, Object, Boolean)	返回具有指定属性 ID 和属性值的文本范围子集。
FindText(String, Boolean, Boolean)	返回包含指定文本的文本范围子集。
GetAttributeValue(Int32)	检索文本范围内指定属性 ID 的值。
GetBoundingRectangles(Double[])	检索由文本范围中每个完全或部分可见的文本行的边框组成的集合。
GetChildren()	检索文本范围内存在的所有嵌入对象的集合。
GetEnclosingElement()	返回包含文本范围的最内层元素。
GetText(Int32)	检索文本范围的纯文本。
Move(TextUnit, Int32)	将文本范围移动指定数量的文本单位。
MoveEndpointByRange(TextPatternRangeEndpoint, ITextRangeProvider, TextPatternRangeEndpoint)	将文本范围的一个端点移动到第二个文本范围的指定端点。
MoveEndpointByUnit(TextPatternRangeEndpoint, TextUnit, Int32)	在文档范围内将文本范围的一个端点移动指定数量的文本单位。
RemoveFromSelection()	从支持多个不连续选择的文本容器中突出显示的文本集合中，删除与调用方的文本范围终结点相对应的突出显示文本部分。
ScrollIntoView(Boolean)	导致文本控件垂直滚动，直到文本范围在视区中可见。
Select()	突出显示文本控件中对应于文本范围的开始和结束端点的文本。

另请参阅

• ITextProvider
• Text 和 TextRange 控件模式
• 自定义的自动化对等
• ITextRangeProvider (COM 接口)