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:
- ITextRangeProvider::GetEnclosingElement mengembalikan elemen turunan itu sendiri, atau turunan terdalam dari elemen turunan yang berbagi rentang teks yang sama dengan elemen turunan
- ITextRangeProvider::GetChildren mengembalikan turunan elemen dari (1) yang sepenuhnya diapit dalam rentang
- 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
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.
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.
- Kasus 1: ITextProvider stream dan seluruh rentang teks
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