ITextProvider::Metode GetSelection (uiautomationcore.h)

Artikel
08/26/2023

Mengambil kumpulan rentang teks yang mewakili teks yang saat ini dipilih dalam kontrol berbasis teks.

Sintaks

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

Parameter

[out, retval] pRetVal

Jenis: SAFEARRAY**

Menerima alamat array pointer ke antarmuka ITextRangeProvider dari rentang teks, satu untuk setiap rentang teks yang dipilih. 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

Untuk penyedia Automation UI yang mendukung pemilihan teks, penyedia harus menerapkan metode ini dan juga mengembalikan nilai ITextProvider::SupportedTextSelection .

Jika kontrol hanya berisi satu rentang teks yang dipilih, array pRetVal harus berisi satu rentang teks.

Jika kontrol berisi titik penyisipan teks tetapi tidak ada teks yang dipilih, array pRetVal harus berisi rentang teks degenerasi (kosong) pada posisi titik penyisipan teks.

Jika kontrol tidak berisi teks yang dipilih, atau jika kontrol tidak berisi titik penyisipan teks, atur pRetVal ke NULL.

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)