Fungsi AccessibleObjectFromPoint (oleacc.h)

Artikel
03/13/2024

Mengambil alamat penunjuk antarmuka IAccessible untuk objek yang ditampilkan pada titik tertentu di layar.

Sintaks

HRESULT AccessibleObjectFromPoint(
  [in]  POINT       ptScreen,
  [out] IAccessible **ppacc,
  [out] VARIANT     *pvarChild
);

Parameter

[in] ptScreen

Menentukan, dalam koordinat layar fisik, titik yang diperiksa.

[out] ppacc

Alamat variabel pointer yang menerima alamat antarmuka IAccessible objek.

[out] pvarChild

Alamat struktur VARIAN yang menentukan apakah penunjuk antarmuka IAccessible yang dikembalikan dalam ppacc milik objek yang ditampilkan pada titik yang ditentukan, atau ke induk elemen pada titik yang ditentukan. Anggota vtvarian selalu VT_I4. Jika anggota lVal CHILDID_SELF, maka penunjuk antarmuka IAccessible di ppacc milik objek pada titik tersebut. Jika anggota lVal tidak CHILDID_SELF, ppacc adalah alamat antarmuka IAccessible dari objek induk elemen anak. Klien harus memanggil VariantClear pada parameter VARIAN yang diambil setelah selesai menggunakannya.

Nilai kembali

Jika berhasil, mengembalikan S_OK.

Jika tidak berhasil, mengembalikan salah satu dari kode kesalahan COM standar berikut atau lainnya.

Menampilkan kode	Deskripsi
E_INVALIDARG	Argumen tidak valid.

Keterangan

Fungsi ini mengambil objek yang dapat diakses tingkat terendah dalam hierarki objek pada titik tertentu. Jika elemen pada titik tersebut bukan objek yang dapat diakses (yaitu, tidak mendukung IAccessible), maka fungsi mengambil antarmuka IAccessible dari objek induk. Objek induk harus memberikan informasi tentang elemen anak melalui antarmuka IAccessible . Panggil IAccessible::accHitTest untuk mengidentifikasi elemen anak pada koordinat layar yang ditentukan.

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.

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