ITextRangeProvider::Metode GetChildren (uiautomationcore.h)

Mengambil kumpulan semua elemen yang terkandung (baik sebagian atau seluruhnya) dalam rentang teks yang ditentukan, dan merupakan elemen turunan dari elemen penutup untuk rentang teks yang ditentukan.

Sintaks

HRESULT GetChildren(
  [out, retval] SAFEARRAY **pRetVal
);

Parameter

[out, retval] pRetVal

Jenis: SAFEARRAY**

Array pointer ke antarmuka IRawElementProviderSimple untuk semua elemen anak yang diapit oleh rentang teks (diurutkan menurut titik akhir Mulai rentangnya).

Jika rentang teks tidak menyertakan elemen turunan apa pun, koleksi kosong akan dikembalikan.

Parameter ini diteruskan tanpa diinisialisasi.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Setiap elemen yang diambil dengan ITextRangeProvider::GetChildren memiliki rentang teks yang valid yang dapat diambil melalui RangeFromChild. Ini termasuk elemen apa pun di pohon Automation UI antara ITextProvider dan elemen turunan.

Contoh

1. Contoh ini memperlihatkan aliran teks yang berisi tautan gambar. Tautan adalah anak dari gambar, tetapi keduanya mencakup rentang teks yang sama dan diekspos sebagai objek yang disematkan dalam aliran teks.

   Hello <Image Link> World

   • Gambar dan tautan juga merupakan turunan dari ITextProvider aliran, dan dapat ditentukan sebagai childElement dalam panggilan ke ITextProvider::RangeFromChild.
   • Memanggil ITextRangeProvider::RangeFromChild, menggunakan gambar atau tautan, mengembalikan rentang teks yang sama (Rentang1).
   • GetChildren tidak mengembalikan tautan.
   • GetEnclosingElement tidak mengembalikan gambar untuk rentang teks apa pun.
   • GetEnclosingElement pada Rentang1 mengembalikan tautan.
   • GetChildren di Range1 tidak mengembalikan anak apa pun.
   • GetEnclosingElement pada rentang teks untuk ITextProvider aliran mengembalikan penyedia.
   • GetChildren pada rentang teks untuk ITextProvider stream hanya mengembalikan gambar.

2. Contoh ini memperlihatkan aliran teks yang berisi tabel dua sel yang dikelilingi oleh teks.

   Mulai teks

   Sel Tabel 1

   Sel Tabel 2

   Akhiri Teks

   • Kasus 1: ITextProvider stream dan seluruh rentang teks
     • ITextRangeProvider::GetEnclosingElement pada seluruh rentang teks mengembalikan ITextProvider aliran.
     • GetChildren mengembalikan semua elemen turunan dari ITextProvider aliran, hanya elemen tabel dalam kasus ini.
   • Kasus 2: Rentang teks yang diperoleh dengan memanggil ITextProvider::RangeFromChild pada elemen tabel:
     • ITextRangeProvider::GetEnclosingElement mengembalikan elemen tabel.
     • ITextRangeProvider::GetChildren mengembalikan kedua sel tabel.
   • Kasus 3: Rentang teks yang mencakup konten visual Sel Tabel 1 Sel Tabel 2:
     • ITextRangeProvider::GetEnclosingElement mengembalikan elemen tabel.
     • ITextRangeProvider::GetChildren mengembalikan kedua sel tabel.
   • Kasus 4: Rentang teks yang mencakup kata SelTabel 1:
     • ITextRangeProvider::GetEnclosingElement mengembalikan elemen sel pertama.
     • ITextRangeProvider::GetChildren tidak mengembalikan elemen.
   • Kasus 5: Rentang teks degenerasi (kosong) yang mewakili mulai (tabel dan sel pertama):
     • ITextRangeProvider::GetEnclosingElement mengembalikan elemen sel pertama (elemen terdalam dengan rentang yang menyertakan rentang degenerasi).
     • ITextRangeProvider::GetChildren tidak mengembalikan elemen.

Persyaratan

Klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	uiautomationcore.h (termasuk UIAutomation.h)

Lihat juga

ITextProvider, ITextRangeProvider, GetEnclosingElement, ITextProvider::RangeFromChild, Gambaran Umum Penyedia Automasi UI, Praktik Terbaik untuk Menggunakan Array Aman