Metode IUIAutomationTextPattern::GetVisibleRanges (uiautomationclient.h)
Mengambil array rentang teks terputus-putus dari kontrol berbasis teks di mana setiap rentang teks mewakili rentang teks yang berdampingan.
Sintaks
HRESULT GetVisibleRanges(
[out, retval] IUIAutomationTextRangeArray **ranges
);
Parameter
[out, retval] ranges
Jenis: IUIAutomationTextRangeArray**
Menerima penunjuk ke kumpulan rentang teks yang terlihat dalam kontrol berbasis teks.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Jika teks yang terlihat terdiri dari satu rentang teks yang berdampingan, array rentang akan berisi rentang teks tunggal yang mewakili semua teks yang terlihat.
Jika teks yang terlihat terdiri dari beberapa, rentang teks yang tidak terputus-putus, array rentang akan berisi satu rentang teks untuk setiap rentang yang terlihat, dimulai dengan rentang pertama yang terlihat, dan berakhir dengan rentang terakhir yang terlihat. Rentang teks yang tidak terputus-putus dapat terjadi ketika konten kontrol berbasis teks sebagian dikaburkan oleh jendela yang tumpang tindih atau objek lain, atau ketika kontrol berbasis teks dengan beberapa halaman atau kolom memiliki konten yang sebagian digulir keluar dari tampilan.
IUIAutomationTextPattern::GetVisibleRanges mengambil rentang teks degenerasi (kosong) jika tidak ada teks yang terlihat, jika semua teks digulir keluar dari tampilan, atau jika kontrol berbasis teks tidak berisi teks.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista, Windows XP dengan SP3 dan Pembaruan Platform untuk Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008, Windows Server 2003 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | uiautomationclient.h (termasuk UIAutomation.h) |