Metode IAccessible::get_accSelection (oleacc.h)

Artikel
03/08/2023

Metode IAccessible::get_accSelection mengambil anak yang dipilih dari objek ini. Semua objek yang mendukung pilihan harus mendukung properti ini.

Sintaks

HRESULT get_accSelection(
  [out, retval] VARIANT *pvarChildren
);

Parameter

[out, retval] pvarChildren

Jenis: VARIAN*

Alamat struktur VARIAN yang menerima informasi tentang anak mana yang dipilih. Tabel berikut ini menjelaskan informasi yang dikembalikan di pvarChildren.

anggota vt	Anggota nilai
VT_EMPTY	Tidak ada anak yang dipilih.
VT_DISPATCH	Satu objek anak dipilih, dan alamat antarmuka IDispatch-nya diatur dalam anggota pdispVal .
VT_I4	lVal berisi ID anak dari elemen anak yang dipilih. Jika lVal CHILDID_SELF, ini berarti objek itu sendiri dipilih.
VT_UNKNOWN	Beberapa objek anak dipilih, dan anggota punkVal berisi alamat antarmuka IUnknown . Klien meminta antarmuka ini untuk antarmuka IEnumVARIANT , yang digunakannya untuk menghitung objek yang dipilih.

Nilai kembali

Jenis: HRESULT

Jika berhasil, mengembalikan S_OK.

Jika tidak berhasil, mengembalikan salah satu nilai dalam tabel berikut, atau kode kesalahan COM standar lainnya. Server mengembalikan nilai-nilai ini, tetapi klien harus selalu memeriksa parameter output untuk memastikan bahwa nilai tersebut berisi nilai yang valid. Untuk informasi selengkapnya, lihat Memeriksa Nilai Pengembalian IAccessible.

Kesalahan	Deskripsi
DISP_E_MEMBERNOTFOUND	Objek tidak mendukung properti ini.

Keterangan

Metode ini harus mendukung antarmuka IEnumVARIANT .

Metode ini mengembalikan penunjuk antarmuka IDispatch atau ID anak untuk parameter pvarChildren . Untuk informasi selengkapnya tentang cara menggunakan penunjuk antarmuka IDispatch atau ID anak, lihat Cara ID Anak Digunakan dalam Parameter.

Seperti metode dan fungsi IAccessible lainnya, klien mungkin menerima kesalahan untuk penunjuk antarmuka IAccessible karena tindakan pengguna. Untuk informasi selengkapnya, lihat Menerima Kesalahan untuk Penunjuk Antarmuka IAccessible.

Catatan: Metode ini mengambil item terpilih, bukan teks terpilih.

Contoh Server

Contoh kode berikut menunjukkan kemungkinan implementasi metode ini untuk kotak daftar pilihan tunggal kustom. Metode GetSelectedIndex-nya mengembalikan -1 jika tidak ada item yang dipilih.


// m_pControl is the control that returns this accessible object. 

HRESULT STDMETHODCALLTYPE AccServer::get_accSelection(VARIANT *pvarChildren)
{
    int childID = m_pControl->GetSelectedIndex() + 1; // Convert from 0-based. 
    if (childID <= 0)
    {
        pvarChildren->vt = VT_EMPTY;
    }
    else 
    {
        pvarChildren->vt = VT_I4;
        pvarChildren->lVal = childID;
    }
    return S_OK;
};

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	oleacc.h
Pustaka	Oleacc.lib
DLL	Oleacc.dll
Redistribusi	Aksesibilitas Aktif 1.3 RDK di Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 95