Properti Peran

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

Dalam banyak kasus, peran objek sudah 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

Aksesibilitas Aktif Microsoft 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 fungsi GetRoleText 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 digambarkan sebagai ROLE_SYSTEM_GRAPHIC dengan properti Status diatur 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 bisa 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, gunakan ROLE_SYSTEM_PUSHBUTTON.