ITextRangeProvider::GetEnclosingElement method (uiautomationcore.h)

Mengembalikan elemen terda dalam yang mengapit rentang teks yang ditentukan.

Sintaks

HRESULT GetEnclosingElement(
  [out, retval] IRawElementProviderSimple **pRetVal
);

Parameter

[out, retval] pRetVal

Jenis: IRawElementProviderSimple**

Penyedia Automation UI dari elemen terdalam yang menyertakan ITextRangeProvider yang ditentukan.

Catatan

Elemen penutup dapat mencakup lebih dari sekadar ITextRangeProvider yang ditentukan.

Jika tidak ada elemen penutup yang ditemukan, induk ITextProvider dari ITextRangeProvider 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

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

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