Bagikan melalui


IAccessible::accSelect method (oleacc.h)

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

Lihat juga

IAccessible

IAccessible::get_accFocus

IAccessible::get_accSelection

SELFLAG

Properti dan Metode Pemilihan dan Fokus

VARIAN