Peran Objek
Topik ini menjelaskan nilai konstanta yang digunakan untuk menjelaskan peran berbagai objek UI dalam aplikasi. Konstanta peran didefinisikan dalam file Oleacc.h.
Anda hanya boleh menggunakan konstanta peran yang tercantum di sini; jangan tambahkan peran atau peran kustom yang tidak ditentukan sebelumnya.
Sebelum menggunakan peran objek ini, pengembang aplikasi klien harus menggunakan alat Inspeksi untuk memverifikasi bahwa peran objek sedang digunakan oleh elemen UI.
Untuk mengambil peran objek, klien memanggil metode IAccessible::get_accRole , yang harus mengembalikan salah satu nilai yang dijelaskan dalam tabel. Untuk mengambil string yang dilokalkan yang menjelaskan peran objek, klien memanggil fungsi GetRoleText dengan nilai peran. String yang dilokalkan untuk nilai peran ada dalam file oleaccrc.dll.
| Terus-menerus | Deskripsi |
|---|---|
|
Objek mewakili pemberitahuan atau kondisi yang harus diberitahukan pengguna. Peran ini hanya digunakan untuk objek yang mewujudkan pemberitahuan tetapi tidak terkait dengan elemen antarmuka pengguna lain, seperti kotak pesan, grafik, teks, atau suara. |
|
Objek mewakili kontrol animasi yang kontennya berubah dari waktu ke waktu, seperti kontrol yang menampilkan serangkaian bingkai bitmap. Kontrol animasi ditampilkan ketika file disalin atau ketika beberapa tugas lain yang memakan waktu dilakukan. |
|
Objek mewakili jendela utama untuk aplikasi. |
|
Objek mewakili batas jendela. Seluruh batas diwakili oleh objek tunggal daripada oleh objek terpisah untuk setiap sisi. |
|
Objek mewakili tombol yang memperluas daftar item. |
|
Objek mewakili tombol yang memperluas kisi. |
|
Objek mewakili tombol yang memperluas menu. |
|
Objek mewakili tanda sisipan sistem. |
|
Objek mewakili sel di dalam tabel. |
|
Objek mewakili objek grafis seperti kartun, seperti Asisten Microsoft Office, yang ditampilkan untuk memberikan bantuan kepada pengguna aplikasi. |
|
Objek mewakili gambar grafis yang digunakan untuk membuat bagan data. |
|
Objek mewakili kontrol kotak centang: opsi yang dipilih atau dikosongkan secara independen dari opsi lain. |
|
Objek mewakili area klien jendela. Aksesibilitas Aktif Microsoft menggunakan peran ini sebagai default jika ada pertanyaan tentang peran elemen UI. |
|
Objek mewakili kontrol yang menampilkan waktu. |
|
Objek mewakili kolom sel dalam tabel. |
|
Objek mewakili header kolom, menyediakan label visual untuk kolom dalam tabel. |
|
Objek mewakili kotak kombo: kontrol edit dengan kotak daftar terkait yang menyediakan sekumpulan pilihan yang telah ditentukan sebelumnya. |
|
Objek mewakili penunjuk mouse sistem. |
|
Objek mewakili gambar grafis yang digunakan untuk diagram data. |
|
Objek mewakili kenop atau kenop. |
|
Objek mewakili kotak dialog atau kotak pesan. |
|
Objek mewakili jendela dokumen. Jendela dokumen selalu terkandung dalam jendela aplikasi. Peran ini hanya berlaku untuk jendela MDI dan mengacu pada objek yang berisi bilah judul MDI. |
|
Objek mewakili kontrol kalender, SysDateTimePick32. Komponen runtime Microsoft Active Accessibility menggunakan peran ini untuk menunjukkan bahwa tanggal atau kontrol kalender telah ditemukan. |
|
Objek mewakili persamaan matematika. |
|
Objek mewakili gambar. |
|
Objek mewakili penunjuk mouse khusus yang memungkinkan pengguna untuk memanipulasi elemen antarmuka pengguna seperti jendela. Salah satu contohnya adalah mengubah ukuran jendela dengan menyeret sudut kanan bawahnya. |
|
Objek secara logis mengelompokkan objek lain. Tidak selalu ada hubungan induk-anak antara objek pengelompokan dan objek yang dikandungnya. |
|
Objek menampilkan topik bantuan dalam bentuk tipsalat atau balon bantuan. |
|
Objek mewakili bidang pintasan keyboard yang memungkinkan pengguna memasukkan kombinasi atau urutan penekanan tombol. |
|
Objek mewakili indikator, seperti grafik penunjuk, yang menunjuk ke item saat ini. |
|
Objek mewakili kontrol edit yang dirancang untuk alamat IP. Kontrol edit dibagi menjadi beberapa bagian, masing-masing untuk bagian tertentu dari alamat IP. |
|
Objek mewakili tautan ke sesuatu yang lain. Objek ini mungkin terlihat seperti teks atau grafik, tetapi bertindak seperti tombol. |
|
Objek mewakili kotak daftar, memungkinkan pengguna memilih satu atau beberapa item. |
|
Objek mewakili item dalam kotak daftar atau di bagian daftar kotak kombo, kotak daftar drop-down, atau kotak kombo turun bawah. |
|
Objek mewakili bilah menu (diposisikan di bawah bilah judul jendela) tempat pengguna memilih menu. |
|
Objek mewakili item menu: entri menu yang dapat dipilih pengguna untuk melakukan perintah, memilih opsi, atau menampilkan menu lain. Secara fungsional, item menu setara dengan tombol tekan, tombol radio, kotak centang, atau menu. |
|
Objek mewakili menu: daftar opsi, masing-masing dengan tindakan tertentu. Semua jenis menu harus memiliki peran, termasuk menu drop-down yang ditampilkan saat dipilih dari bilah menu; dan menu pintasan, yang ditampilkan dengan mengklik tombol kanan mouse. |
|
Objek mewakili kerangka atau struktur pohon, seperti kontrol tampilan pohon, yang menampilkan daftar hierarkis dan memungkinkan pengguna untuk memperluas dan menciutkan cabang. |
|
Objek mewakili item yang menavigasi seperti item kerangka. Tombol PANAH ATAS dan BAWAH digunakan untuk menavigasi melalui kerangka. Namun, alih-alih memperluas dan menciutkan saat tombol PANAH KIRI dan KANAN ditekan, menu ini diperluas atau diciutkan saat tombol SPACEBAR atau ENTER ditekan dan item memiliki fokus. |
|
Objek mewakili item dalam struktur kerangka atau pohon. |
|
Objek mewakili tab halaman. Satu-satunya turunan dari kontrol tab halaman adalah objek ROLE_SYSTEM_GROUPING yang memiliki konten halaman terkait. |
|
Objek mewakili kontainer kontrol tab halaman. |
|
Objek mewakili panel dalam bingkai atau jendela dokumen. Pengguna dapat menavigasi antar panel dan di dalam konten panel saat ini, tetapi tidak dapat menavigasi antar item di panel yang berbeda. Dengan demikian, panel mewakili tingkat pengelompokan yang lebih rendah dari bingkai atau jendela dokumen, tetapi lebih tinggi dari kontrol individual. Pengguna menavigasi antar panel dengan menekan TAB, F6, atau CTRL+TAB, tergantung pada konteksnya. |
|
Objek mewakili bilah kemajuan, yang secara dinamis menunjukkan berapa banyak operasi yang sedang berlangsung telah selesai. Kontrol ini tidak mengambil input pengguna. |
|
Objek mewakili lembar properti. |
|
Objek mewakili kontrol tombol tekan. |
|
Objek mewakili tombol opsi (sebelumnya, tombol radio). Ini adalah salah satu dari sekelompok opsi yang saling eksklusif. Semua objek yang memiliki induk yang sama dan yang memiliki atribut ini diasumsikan sebagai bagian dari satu grup yang saling eksklusif. Untuk membagi objek ini menjadi grup terpisah, gunakan objek ROLE_SYSTEM_GROUPING. |
|
Objek mewakili baris sel dalam tabel. |
|
Objek mewakili header baris, yang menyediakan label visual untuk baris tabel. |
|
Objek mewakili bilah gulir vertikal atau horizontal, yang merupakan bagian dari area klien atau digunakan dalam kontrol. |
|
Objek digunakan untuk membagi ruang secara visual menjadi dua wilayah. Contoh objek pemisah termasuk item menu pemisah, dan bilah yang membagi panel terpisah dalam jendela. |
|
Objek mewakili slider, yang memungkinkan pengguna untuk menyesuaikan pengaturan khususnya kenaikan antara nilai minimum dan maksimum. |
|
Objek mewakili suara sistem, yang terkait dengan berbagai peristiwa sistem. |
|
Objek mewakili kotak putar, yang merupakan kontrol yang memungkinkan pengguna untuk menaikkan atau mengurangi nilai yang ditampilkan dalam kontrol "teman" terpisah yang terkait dengan kotak putar. |
|
Objek mewakili tombol pada toolbar yang memiliki ikon daftar drop-down yang berdekatan langsung dengan tombol. |
|
Objek mewakili teks baca-saja, seperti label untuk kontrol atau instruksi lain dalam kotak dialog. Teks statis tidak dapat diubah atau dipilih. |
|
Objek mewakili bilah status, yang merupakan area di bagian bawah jendela dan yang menampilkan informasi tentang operasi saat ini, status aplikasi, atau objek yang dipilih. Bilah status memiliki beberapa bidang, yang menampilkan berbagai jenis informasi. |
|
Objek mewakili tabel yang berisi baris dan kolom sel, dan, secara opsional, header baris dan header kolom. |
|
Objek mewakili teks yang dapat dipilih yang memungkinkan pengeditan atau ditetapkan sebagai baca-saja. |
|
Objek mewakili judul atau bilah caption untuk jendela. |
|
Objek mewakili toolbar, yang merupakan pengelompokan kontrol yang menyediakan akses mudah ke fitur yang sering digunakan. |
|
Objek mewakili tipsalat yang memberikan petunjuk bermanfaat. |
|
Objek mewakili ruang kosong di antara objek lain. |
|
Objek mewakili bingkai jendela, yang berisi objek anak seperti bilah judul, klien, dan objek jendela lainnya. |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|