IAccessible::accSelect method (oleacc.h)

Artikel
03/05/2024

Metode IAccessible::accSelect memodifikasi pilihan atau memindahkan fokus keyboard objek yang ditentukan. Semua objek yang mendukung pemilihan atau menerima fokus keyboard harus mendukung metode ini.

Sintaks

HRESULT accSelect(
  [in] long    flagsSelect,
  [in] VARIANT varChild
);

Parameter

[in] flagsSelect

Jenis: panjang

Menentukan pilihan atau operasi fokus mana yang akan dilakukan. Parameter ini harus memiliki kombinasi Konstanta SELFLAG.

[in] varChild

Jenis: VARIAN

Menentukan objek terpilih. Jika nilainya CHILDID_SELF, objek itu sendiri dipilih; jika ID anak, salah satu elemen anak objek dipilih. Untuk informasi selengkapnya tentang menginisialisasi struktur VARIAN, lihat Bagaimana ID Anak Digunakan dalam Parameter.

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.

Kesalahan	Deskripsi
S_FALSE	Objek yang ditentukan tidak dipilih.
E_INVALIDARG	Argumen tidak valid. Nilai pengembalian ini berarti bahwa kombinasi SELFLAG yang ditentukan tidak valid, atau bahwa nilai SELFLAG tidak masuk akal untuk objek yang ditentukan. Misalnya, bendera berikut ini tidak diizinkan pada kotak daftar pilihan tunggal: SELFLAG_EXTENDSELECTION, SELFLAG_ADDSELECTION, dan SELFLAG_REMOVESELECTION.
DISP_E_MEMBERNOTFOUND	Objek tidak mendukung metode ini.

Keterangan

Aplikasi klien menggunakan metode ini untuk melakukan operasi pemilihan yang kompleks. Untuk informasi selengkapnya, lihat Memilih Objek Anak. Metode ini menyediakan cara paling sederhana untuk mengalihkan fokus input antar aplikasi secara terprogram. Ini berlaku untuk aplikasi yang berjalan di Windows 2000.

Catatan: Metode ini untuk pemilihan item, bukan teks.

Contoh Klien

Contoh fungsi berikut memilih item pada titik tertentu di layar. Diasumsikan bahwa satu pilihan diinginkan.


HRESULT SelectItemAtPoint(POINT point)
{
    VARIANT varItem;
    IAccessible* pAcc;
    HRESULT hr = AccessibleObjectFromPoint(point, &pAcc, &varItem);
    if ((hr == S_OK))
    {
        hr = pAcc->accSelect((SELFLAG_TAKEFOCUS | SELFLAG_TAKESELECTION), varItem);
        VariantClear(&varItem);
        pAcc->Release();
    }
    return hr;
}

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