Bagikan melalui

Pola Kontrol TextChild

  • Artikel

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.

cuplikan layar memperlihatkan teks yang berisi gambar yang disematkan dan hyperlink

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. Misalnya:

cuplikan layar memperlihatkan pemeriksaan pelaporan sampel pohon elemen automation ui

Biasanya, elemen dokumen dalam contoh sebelumnya mendukung pola kontrol Teks, tetapi dua anak 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.

Pedoman dan Konvensi Implementasi

Saat menerapkan antarmukaITextChildProvider, perhatikan panduan dan konvensi berikut:

  • Properti ITextChildProvider::TextContainer harus menentukan elemen leluhur terdekat yang mendukung antarmukaITextProvider, terlepas dari apakah elemen yang lebih tinggi dalam rantai leluhur juga mendukung ITextProvider.
  • Elemen tidak boleh mendukungITextProvider dan antarmuka ITextChildProvider**.
  • Elemen yang mengimplementasikan ITextChildProvider harus berupa turunan, atau turunan, dari elemen yang mengimplementasikan ITextProvider. Tidak diharuskan bahwa elemen ini juga menerapkan pola kontrol Teks .
  • PropertiITextChildProvider::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 menerapkan antarmukaITextChildProvider.

Anggota yang diperlukan Jenis anggota Catatan
TextContainer Harta benda Tidak
TextRange Harta benda Tidak

 

Pola kontrol ini tidak memiliki metode atau peristiwa terkait.

Konseptual