Konstanta Status Objek
Topik ini menjelaskan nilai konstanta yang digunakan untuk menjelaskan status objek dalam antarmuka pengguna aplikasi. Konstanta status didefinisikan dalam oleacc.h.
Objek dikaitkan dengan satu atau beberapa nilai status ini kapan saja. Konstanta status objek berikut tidak digunakan: STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW, dan STATE_SYSTEM_FLOATING.
Klien mengambil status objek dengan memanggil IAccessible::get_accState, yang mengembalikan bilangan bulat yang merupakan kombinasi dari bendera bit berikut. Klien memanggil GetStateText dengan nilai status untuk mengambil string yang dilokalkan yang menjelaskan status objek.
Ketika status objek berubah, server harus memanggil NotifyWinEvent dengan konstanta peristiwa EVENT_OBJECT_STATECHANGE . Namun, objek dengan konstanta status objek STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED, dan STATE_SYSTEM_ SELECTED memiliki konstanta peristiwa mereka sendiri. Untuk objek ini, jangan gunakan EVENT_OBJECT_STATECHANGE. Sebagai gantinya, gunakan konstanta peristiwa individual.
Berikut ini adalah konstanta status objek:
| Terus-menerus | Deskripsi |
|---|---|
|
(Konstanta status objek ini tidak didukung.) Menunjukkan informasi penting untuk segera disampaikan kepada pengguna. Misalnya, ketika baterai mencapai tingkat yang sangat rendah, indikator tingkat menghasilkan pemberitahuan tingkat tinggi. Akibatnya, alat akses buta segera mengumumkan informasi ini kepada pengguna, dan program pembesaran layar menggulir layar sehingga indikator baterai terlihat. Status ini juga sesuai untuk setiap perintah atau operasi yang harus diselesaikan sebelum pengguna dapat melanjutkan. |
|
(Konstanta status objek ini tidak didukung.) Menunjukkan informasi penting yang tidak segera disampaikan kepada pengguna. Misalnya, ketika baterai mulai mencapai tingkat rendah, indikator tingkat menghasilkan pemberitahuan tingkat menengah. Alat akses buta kemudian menghasilkan suara untuk memberi tahu pengguna bahwa informasi penting tersedia, tanpa benar-benar mengganggu pekerjaan pengguna. Pengguna kemudian dapat mengkueri informasi pemberitahuan jika nyaman. |
|
(Konstanta status objek ini tidak didukung.) Menunjukkan informasi berprioritas rendah yang tidak penting untuk pengguna. Status ini digunakan, misalnya, ketika Word mengubah tampilan tombol TipWizard pada toolbar-nya untuk menunjukkan bahwa ia memiliki petunjuk untuk pengguna. |
|
Tampilan objek berubah dengan cepat atau konstan. Grafik yang dianimasikan sesekali digambarkan sebagai ROLE_SYSTEM_GRAPHIC dengan properti Status diatur ke STATE_SYSTEM_ANIMATED. Status ini digunakan untuk menunjukkan bahwa lokasi objek berubah. |
|
Kontrol tidak dapat menerima input saat ini. |
|
Kotak centang objek dipilih. |
|
Anak-anak objek yang memiliki peran ROLE_SYSTEM_OUTLINEITEM disembunyikan. |
|
Status ini mewakili tombol default dalam jendela. |
|
Anak-anak objek yang memiliki peran ROLE_SYSTEM_OUTLINEITEM ditampilkan. |
|
Menunjukkan bahwa objek memperluas pilihannya dengan menggunakan SELFLAG_EXTENDSELECTION dalam metode IAccessible::accSelect. |
|
(Konstanta status objek ini tidak didukung.) Objek tidak dipotong ke batas objek induknya, dan tidak bergerak secara otomatis ketika induk bergerak. |
|
Objek berada di jendela aktif dan siap menerima fokus keyboard. |
|
Objek memiliki fokus keyboard. Jangan membingungkan fokus objek dengan pemilihan objek. Untuk informasi selengkapnya, lihat Properti dan Metode Pemilihan dan Fokus. Untuk objek dengan status objek ini, kirim EVENT_OBJECT_SHOW atau EVENT_OBJECT_HIDE WinEvents untuk memberi tahu aplikasi klien tentang perubahan status. Jangan gunakan EVENT_OBJECT_STATECHANGE. |
|
Saat dipanggil, objek menampilkan menu pop-up atau jendela. |
|
Objek dilacak panas oleh mouse, yang berarti bahwa penampilan objek telah berubah untuk menunjukkan bahwa penunjuk mouse terletak di atasnya. |
|
Objek disembunyikan secara terprogram. Misalnya, itme menu disembunyikan secara terprogram hingga pengguna mengaktifkan menu. Karena objek dengan status ini tidak tersedia untuk pengguna, aplikasi klien tidak boleh mengomunikasikan informasi tentang objek kepada pengguna. Namun, jika aplikasi klien menemukan objek dengan status ini, mereka harus memeriksa apakah STATE_SYSTEM_OFFSCREEN juga diatur. Jika status kedua ini ditentukan, klien dapat mengomunikasikan informasi tentang objek kepada pengguna. Misalnya, kotak daftar dapat memiliki kumpulan STATE_SYSTEM_INVISIBLE dan STATE_SYSTEM_OFFSCREEN. Dalam hal ini, aplikasi klien dapat mengomunikasikan semua item dalam daftar kepada pengguna. Jika aplikasi klien menavigasi melalui pohon IAccessible dan menemukan objek induk yang tidak terlihat, Aksesibilitas Aktif Microsoft tidak akan mengekspos informasi tentang kemungkinan anak induk selama induk tidak terlihat. |
|
Menunjukkan bahwa objek diformat sebagai hyperlink. Peran objek biasanya akan ROLE_SYSTEM_TEXT. |
|
Menunjukkan pengguliran atau pemindahan teks atau grafik. |
|
Menunjukkan bahwa status kotak centang tiga status atau tombol toolbar tidak ditentukan. Kotak centang tidak dipilih atau dikosongkan dan oleh karena itu dalam keadaan ketiga atau campuran . |
|
Menunjukkan bahwa objek dapat dipindahkan. Misalnya, pengguna dapat mengklik bilah judul objek dan menyeret objek ke lokasi baru. |
|
Menunjukkan bahwa objek menerima beberapa item terpilih; artinya, SELFLAG_ADDSELECTION untuk metode IAccessible::accSelect valid. |
|
Menunjukkan bahwa objek tidak memiliki status lain yang ditetapkan untuk objek tersebut. |
|
Objek dipotong atau telah digulir keluar dari tampilan, tetapi tidak disembunyikan secara terprogram. Jika pengguna membuat viewport lebih besar, lebih banyak objek akan terlihat di layar komputer. |
|
Objek ditekan. |
|
Objek adalah kontrol edit yang dilindungi kata sandi. |
|
Objek ditunjuk baca-saja. |
|
Objek menerima pilihan. |
|
Objek dipilih. |
|
Objek atau anak menggunakan teknologi teks ke ucapan (TTS) untuk tujuan deskripsi. Ketika objek dengan status ini memiliki fokus, bantuan aksesibilitas berbasis ucapan tidak mengumumkan informasi karena objek secara otomatis mengumumkannya. |
|
Objek dapat diubah ukurannya. Misalnya, pengguna dapat mengubah ukuran jendela dengan menyeretnya ke tepi. |
|
Objek adalah hyperlink yang telah dikunjungi (sebelumnya diklik) oleh pengguna. |
|
Objek tidak tersedia. |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|