Metode IAccessible::get_accSelection (oleacc.h)

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

Lihat juga

IAccessible

IAccessible::accSelect

IAccessible::get_accFocus

IDispatch

Properti dan Metode Pemilihan dan Fokus

VARIAN