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