ITextProvider2 介面

定義

命名空間:

Windows.UI.Xaml.Automation.Provider

擴充 ITextProvider 介面，讓 Microsoft UI 自動化提供者公開批註或選取目標文字內容。 實作此介面，以支援自動化用戶端使用 GetPattern 呼叫和 PatternInterface.Text2要求的功能。

public interface class ITextProvider2 : ITextProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(3743238332, 1159, 20095, 157, 94, 240, 158, 119, 228, 18, 70)]
struct ITextProvider2 : ITextProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(3743238332, 1159, 20095, 157, 94, 240, 158, 119, 228, 18, 70)]
public interface ITextProvider2 : ITextProvider

Public Interface ITextProvider2
Implements ITextProvider

屬性

ContractVersionAttribute GuidAttribute

實作

ITextProvider

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

如需此模式的詳細資訊，請參閱 文字和 TextRange 控制項模式。

ITextProvider、ITextProvider2和ITextRangeProvider不會由任何使用介面定義的現有Windows 執行階段自動化對等實作。 Windows 執行階段TextBox和RichTextBlock等文字控制項所支援的文字模型會實作其中一些模式，但在 API 介面的Windows 執行階段定義中不會顯示這類模式的原生層級執行此動作。 如需詳細資訊，請參閱各種Windows 執行階段文字控制項的對等類別。

ITextProvider2 模式沒有Windows 執行階段屬性識別碼類別。

介面繼承

ITextProvider2 繼承 ITextProvider。 實作 ITextProvider2 的類型也會實作 ITextProvider的介面成員。

屬性

DocumentRange	取得包含文件主要文字的文字範圍。 (繼承來源 ITextProvider)
SupportedTextSelection	取得值，這個值會指定文字提供者是否支援選取範圍，如果是，則為支援的選取範圍類型。 (繼承來源 ITextProvider)

方法

GetCaretRange(Boolean)	擷取屬於文字型控制項之插入號位置的長度為零的文字範圍。
GetSelection()	擷取與目前文字選取範圍或選取範圍相關聯的脫離文字範圍集合。 (繼承來源 ITextProvider)
GetVisibleRanges()	從文字容器擷取脫離文字範圍的陣列。 每個文字範圍都是以第一個部分可見的行開始，並以最後一個部分可見的行結尾。 (繼承來源 ITextProvider)
RangeFromAnnotation(IRawElementProviderSimple)	公開文字範圍，其中包含與指定注釋專案相關聯的批註目標文字。
RangeFromChild(IRawElementProviderSimple)	擷取包含子專案的文字範圍，例如影像、超連結或其他内嵌物件。 (繼承來源 ITextProvider)
RangeFromPoint(Point)	從螢幕座標附近擷取文字範圍。 (繼承來源 ITextProvider)

另請參閱

• ITextProvider
• 文字和 TextRange 控制項模式
• 自訂自動化對等
• ITextProvider2 (COM 介面)