共用方式為

ITextProvider 介面

  • 參考

定義

命名空間:
Microsoft.UI.Xaml.Automation.Provider
編輯

公開方法和屬性，以支援 Microsoft UI 自動化用戶端存取包含文字的控制項。 實作這個介面，以支援自動化用戶端使用 AutomationPeer.GetPattern 呼叫和 PatternInterface.Text要求的功能。

public interface class ITextProvider
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(937942246, 65146, 22183, 164, 122, 148, 98, 135, 44, 103, 239)]
struct ITextProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.Guid(937942246, 65146, 22183, 164, 122, 148, 98, 135, 44, 103, 239)]
public interface ITextProvider
Public Interface ITextProvider
衍生
屬性
ContractVersionAttribute GuidAttribute

備註

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

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

Windows 執行階段 API 內的 Microsoft UI 自動化介面存在，因此自訂控制項作者可以在自訂控制項中支援自動化模式，並使用與用來定義控制項邏輯或其他自動化支援的相同Windows 執行階段 Managed 或 C++ API 來實作其自動化支援。

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

屬性

DocumentRange

取得包含文件主要文字的文字範圍。
SupportedTextSelection

取得值，這個值會指定文字提供者是否支援選取範圍，如果支援，則為支援的選取範圍類型。

方法

GetSelection()

擷取與目前文字選取範圍或選取範圍相關聯的不相鄰文字範圍集合。
GetVisibleRanges()

從文字容器擷取不相鄰文字範圍的陣列。 每個文字範圍都是以第一個部分可見的行開頭，並以最後一個部分可見的行結尾。
RangeFromChild(IRawElementProviderSimple)

擷取包含子項目的文字範圍，例如影像、超連結或其他内嵌物件。
RangeFromPoint(Point)

從螢幕座標的鄰近位置擷取文字範圍。

適用於

另請參閱