TextChild 控制件模式
介紹實作 ITextChildProvider的指導方針和慣例,包括屬性和方法的相關信息。 TextChild 控制項模式可用來存取支援 Text 控制項模式的專案最接近祖系。
例如,假設檔中的文字包含內嵌影像和超連結,如下圖所示。
如果您使用 Microsoft UI 自動化工具來檢查此文件內容的 UI 自動化樹狀結構,它可能會顯示一個檔案元素,其中一個子元素代表影像,而另一個子元素則代表超連結。 例如:
一般而言,上述範例中的檔元素支援 Text 控件模式,但檔元素的兩個子系則不支援。 如果UI自動化用戶端應用程式具有image元素或超連結項目的參考,則用戶端可以使用 TextChild 控件模式,作為存取包含文件元素所公開的 Textcontrol 模式的便利方式。
實作指導方針和慣例
實作 ITextChildProvider 介面時,請注意下列指導方針和慣例:
- ITextChildProvider::TextContainer 屬性應該指定支援 ITextProvider 介面的最接近上階元素,而不論上階鏈結中的元素是否也支援 ITextProvider。
- 元素不應同時支援ITextProvider 和 ITextChildProvider** 介面。
- 實作 ITextChildProvider 的項目必須是實作 ITextProvider之專案的子系或子代。 此元素不需要也實作 文字控制樣式。
- ITextChildProvider::TextRange 屬性應該指定與包含文字提供者元素的文字範圍相同的文字範圍,當其 ITextProvider::RangeFromChild 函式時,會使用文字子專案做為封閉子元素來呼叫。
ITextChildProvider 的必要成員
實作 ITextChildProvider 介面需要這些屬性和方法。
必要成員 | 成員類型 | 筆記 |
---|---|---|
TextContainer | 財產 | 沒有 |
TextRange | 財產 | 沒有 |
此控件模式沒有相關聯的方法或事件。
相關主題
概念