ITextProvider 介面

  • 參考

定義

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

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

public interface class ITextProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(3680222367, 18439, 20266, 134, 120, 27, 19, 243, 198, 14, 34)]
struct ITextProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(3680222367, 18439, 20266, 134, 120, 27, 19, 243, 198, 14, 34)]
public interface ITextProvider
Public Interface ITextProvider
衍生
屬性
ContractVersionAttribute GuidAttribute

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 執行階段文字控制項的對等類別。

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

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

屬性

DocumentRange

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

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

方法

GetSelection()

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

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

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

從螢幕座標附近擷取文字範圍。

適用於

另請參閱