Pola Kontrol TextChild

Memperkenalkan panduan dan konvensi untuk menerapkan ITextChildProvider, termasuk informasi tentang properti dan metode. Pola kontrol TextChild digunakan untuk mengakses leluhur terdekat elemen yang mendukung pola kontrol Teks .

Misalnya, misalkan teks dalam dokumen berisi gambar yang disematkan dan hyperlink seperti yang diperlihatkan dalam gambar berikut.

Jika Anda menggunakan alat Microsoft UI Automation untuk memeriksa pohon Automation UI untuk konten dokumen ini, itu mungkin menampilkan elemen dokumen dengan satu elemen turunan yang mewakili gambar, dan elemen turunan lain yang mewakili hyperlink. Contohnya:

Biasanya, elemen dokumen dalam contoh sebelumnya mendukung pola kontrol Teks , tetapi dua turunan elemen dokumen tidak. Jika aplikasi klien Automation UI memiliki referensi ke elemen gambar atau elemen hyperlink, klien dapat menggunakan pola kontrol TextChild sebagai cara mudah untuk mengakses pola Textcontrol yang diekspos oleh elemen dokumen yang berisi.

Panduan dan Konvensi Implementasi

Saat menerapkan antarmuka ITextChildProvider , perhatikan panduan dan konvensi berikut:

• Properti ITextChildProvider::TextContainer harus menentukan elemen leluhur terdekat yang mendukung antarmuka ITextProvider , terlepas dari apakah elemen yang lebih tinggi dalam rantai leluhur juga mendukung ITextProvider.
• Elemen tidak boleh mendukung antarmukaITextProvider dan ITextChildProvider** .
• Elemen yang mengimplementasikan ITextChildProvider harus anak, atau turunan, dari elemen yang mengimplementasikan ITextProvider. Tidak diperlukan bahwa elemen ini juga mengimplementasikan pola kontrol Teks.
• Properti ITextChildProvider::TextRange harus menentukan rentang teks yang sama dengan yang dikembalikan elemen penyedia teks yang berisi ketika fungsi ITextProvider::RangeFromChild dipanggil dengan elemen turunan teks sebagai elemen anak yang diapit.

Anggota yang Diperlukan untuk ITextChildProvider

Properti dan metode ini diperlukan untuk mengimplementasikan antarmuka ITextChildProvider .

Anggota yang diperlukan	Jenis anggota	Catatan
TextContainer	Properti	Tidak ada
TextRange	Properti	Tidak ada

 

Pola kontrol ini tidak memiliki metode atau peristiwa terkait.

Topik terkait

Konseptual

• Jenis Kontrol dan Pola Kontrol yang Didukung
• Gambaran Umum Pola Kontrol UI Automation
• Gambaran Umum Pohon UI Automation