ITextProvider::RangeFromChild method (uiautomationcore.h)

Mengambil rentang teks yang menyertakan elemen turunan yang ditentukan (misalnya, gambar, hyperlink, atau objek tersemat lainnya).

Sintaks

HRESULT RangeFromChild(
  [in]          IRawElementProviderSimple *childElement,
  [out, retval] ITextRangeProvider        **pRetVal
);

Parameter

[in] childElement

Jenis: IRawElementProviderSimple*

Penyedia Automation UI dari elemen turunan yang ditentukan.

[out, retval] pRetVal

Jenis: ITextRangeProvider**

Rentang teks yang menyertakan elemen turunan.

Rentang ini sepenuhnya mencakup konten elemen turunan sehingga:

1. ITextRangeProvider::GetEnclosingElement mengembalikan elemen turunan itu sendiri, atau turunan terdalam dari elemen turunan yang berbagi rentang teks yang sama dengan elemen turunan
2. ITextRangeProvider::GetChildren mengembalikan turunan elemen dari (1) yang sepenuhnya diapit dalam rentang
3. Kedua titik akhir rentang berada di batas elemen anak

Parameter ini diteruskan tanpa diinisialisasi.

Nilai kembali

Jenis: HRESULT

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

Catatan

E_INVALIDARG dikembalikan jika childElement bukan merupakan turunan dari ITextProvider, atau tidak diapit oleh rentang teks yang valid.

Keterangan

Setiap elemen yang diambil dengan ITextRangeProvider::GetChildren juga 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).
   • ITextRangeProvider::GetChildren tidak mengembalikan tautan.
   • ITextRangeProvider::GetEnclosingElement tidak mengembalikan gambar untuk rentang teks apa pun.
   • ITextRangeProvider::GetEnclosingElement pada Range1 mengembalikan tautan.
   • ITextRangeProvider::GetChildren on Range1 tidak mengembalikan turunan apa pun.
   • ITextRangeProvider::GetEnclosingElement pada rentang teks untuk ITextProvider aliran mengembalikan penyedia.
   • ITextRangeProvider::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

Persyaratan	Nilai
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, ITextRangeProvider::GetEnclosingElement, ITextRangeProvider::GetChildren, Gambaran Umum Penyedia Automasi UI