Bagikan melalui

Properti Peran

  • Artikel

Properti Peran menjelaskan elemen antarmuka pengguna objek. Semua objek mendukung properti Peran.

Dalam banyak kasus, peran objek jelas. Misalnya, jendela memiliki peran ROLE_SYSTEM_WINDOW dan tombol tekan memiliki peran ROLE_SYSTEM_PUSHBUTTON.

Properti Peran diambil dengan memanggil IAccessible::get_accRole.

Mengidentifikasi Peran Objek

Microsoft Active Accessibility menyediakan konstanta peran, yang ditentukan dalam oleacc.h, yang mengidentifikasi peran objek umum. Disarankan agar pengembang server menggunakan nilai peran yang telah ditentukan sebelumnya ini. Jika konstanta peran yang telah ditentukan sebelumnya dikembalikan, klien menggunakan fungsiGetRoleText untuk mengambil string yang dilokalkan yang menjelaskan peran tersebut.

Untuk kontrol animasi, seperti kontrol animasi yang ditampilkan saat menyalin file, gunakan ROLE_SYSTEM_ANIMATION. Grafik yang terkadang dianimasikan dijelaskan sebagai ROLE_SYSTEM_GRAPHIC dengan propertiStatusdiatur ke STATE_SYSTEM_ANIMATED.

Perhatikan bahwa beberapa peran tidak mudah dijelaskan. Misalnya, tampilan ikon besar folder memungkinkan pengaturan ikon arbitrer, sehingga perannya dapat digambarkan sebagai ROLE_SYSTEM_GROUPING. Atau, kontrol yang menyediakan item dalam baris dan kolom tetap dapat memiliki peran ROLE_SYSTEM_TABLE. Karena peran digunakan untuk mengomunikasikan model penggunaan kepada pengguna akhir, penting untuk menggunakan peran yang sesuai. Misalnya, jika kontrol Anda bertindak seperti tombol, maka gunakan ROLE_SYSTEM_PUSHBUTTON.