ITextRangeProvider 接口

定义

命名空间:

Microsoft.UI.Xaml.Automation.Provider

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

public interface class ITextRangeProvider

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(2216756065, 27874, 20612, 191, 59, 40, 175, 166, 233, 133, 31)]
struct ITextRangeProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.Guid(2216756065, 27874, 20612, 191, 59, 40, 175, 166, 233, 133, 31)]
public interface ITextRangeProvider

Public Interface ITextRangeProvider

派生

Microsoft.UI.Xaml.Automation.Provider.ITextRangeProvider2

属性

ContractVersionAttribute GuidAttribute

注解

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

ITextProvider、ITextProvider2 和 ITextRangeProvider 不是由任何现有Windows 运行时自动化对等方使用接口的此定义实现的。 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 接口)