Metode IAccessible::get_accDefaultAction (oleacc.h)

Artikel
08/25/2023

Metode IAccessible::get_accDefaultAction mengambil string yang menunjukkan tindakan default objek. Tidak semua objek memiliki tindakan default.

Sintaks

HRESULT get_accDefaultAction(
  [in]          VARIANT varChild,
  [out, retval] BSTR    *pszDefaultAction
);

Parameter

[in] varChild

Jenis: VARIAN

Menentukan apakah tindakan default yang diambil dilakukan oleh objek atau salah satu elemen anak objek. Parameter ini CHILDID_SELF (untuk mendapatkan informasi tentang objek) atau ID anak (untuk mendapatkan informasi tentang elemen anak objek). Untuk informasi selengkapnya tentang menginisialisasi struktur VARIAN, lihat Bagaimana ID Anak Digunakan dalam Parameter.

[out, retval] pszDefaultAction

Jenis: BSTR*

Alamat BSTR yang menerima string yang dilokalkan yang menjelaskan tindakan default untuk objek yang ditentukan; jika objek ini tidak memiliki tindakan default, nilainya adalah NULL.

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
S_FALSE	Objek yang ditentukan tidak memiliki tindakan default.
E_INVALIDARG	Argumen tidak valid.
DISP_E_MEMBERNOTFOUND	Objek yang ditentukan tidak mendukung properti ini.

Keterangan

String yang diambil menjelaskan tindakan yang dilakukan pada objek, bukan apa yang dilakukan objek sebagai hasilnya. Misalnya, tombol toolbar yang mencetak dokumen memiliki tindakan default "Tekan" daripada "Mencetak dokumen saat ini."

Jangan membingungkan tindakan default objek dengan nilainya. Untuk informasi selengkapnya, lihat Properti DefaultAction.

Hanya kontrol yang melakukan tindakan yang mendukung metode ini.

Catatan untuk pengembang server: Lokalkan string yang dikembalikan dari properti ini.

Contoh Server

Contoh kode berikut menunjukkan kemungkinan implementasi metode ini untuk kotak daftar kustom. Untuk kesederhanaan, string tidak dilokalkan.


HRESULT STDMETHODCALLTYPE AccServer::get_accDefaultAction( 
    VARIANT varChild,
    BSTR *pszDefaultAction)
{
    if (varChild.vt != VT_I4)
    {
        *pszDefaultAction = NULL;
        return E_INVALIDARG;
    }
    if (varChild.lVal == CHILDID_SELF)
    {
        *pszDefaultAction = SysAllocString(L"None.");
    }
    else
    {
        *pszDefaultAction = SysAllocString(L"Double-click");
    }
    return S_OK;
};

Persyaratan


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

Properti DefaultAction

IAccessible

IAccessible::accDoDefaultAction

VARIAN