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 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:
| Konstan | Deskripsi |
|---|---|
|
STATE_SYSTEM_ALERT_HIGH 0x10000000 |
(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 perintah atau operasi apa pun yang harus diselesaikan sebelum pengguna dapat melanjutkan. |
|
STATE_SYSTEM_ALERT_MEDIUM 0x8000000 |
(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 saat nyaman. |
|
STATE_SYSTEM_ALERT_LOW 0x4000000 |
(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 toolbarnya untuk menunjukkan bahwa ia memiliki petunjuk untuk pengguna. |
|
STATE_SYSTEM_ANIMATED 0x4000 |
Penampilan objek berubah dengan cepat atau konstan. Grafik yang dianimasikan sesekali dijelaskan sebagai ROLE_SYSTEM_GRAPHIC dengan properti Status diatur ke STATE_SYSTEM_ANIMATED. Status ini digunakan untuk menunjukkan bahwa lokasi objek berubah. |
|
STATE_SYSTEM_BUSY 0x800 |
Kontrol tidak dapat menerima input saat ini. |
|
STATE_SYSTEM_CHECKED 0x10 |
Kotak centang objek dipilih. |
|
STATE_SYSTEM_COLLAPSED 0x400 |
Anak-anak objek yang memiliki peran ROLE_SYSTEM_OUTLINEITEM disembunyikan. |
|
STATE_SYSTEM_DEFAULT 0x100 |
Status ini mewakili tombol default dalam jendela. |
|
STATE_SYSTEM_EXPANDED 0x200 |
Anak-anak objek yang memiliki peran ROLE_SYSTEM_OUTLINEITEM ditampilkan. |
|
STATE_SYSTEM_EXTSELECTABLE 0x2000000 |
Menunjukkan bahwa objek memperluas pilihannya dengan menggunakan SELFLAG_EXTENDSELECTION dalam metode IAccessible::accSelect. |
|
STATE_SYSTEM_FLOATING 0x1000 |
(Konstanta status objek ini tidak didukung.) Objek tidak dipotong ke batas objek induknya, dan tidak bergerak secara otomatis ketika induk bergerak. |
|
STATE_SYSTEM_FOCUSABLE 0x100000 |
Objek berada di jendela aktif dan siap menerima fokus keyboard. |
|
STATE_SYSTEM_FOCUSED 0x4 |
Objek memiliki fokus keyboard. Jangan membingungkan fokus objek dengan pemilihan objek. Untuk informasi selengkapnya, lihat Pemilihan dan Properti Fokus dan Metode. 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. |
|
STATE_SYSTEM_HASPOPUP 0x40000000 |
Saat dipanggil, objek menampilkan menu pop-up atau jendela. |
|
STATE_SYSTEM_HOTTRACKED 0x80 |
Objek dilacak panas oleh mouse, yang berarti bahwa penampilan objek telah berubah untuk menunjukkan bahwa penunjuk mouse terletak di atasnya. |
|
STATE_SYSTEM_INVISIBLE 0x8000 |
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 |
|
STATE_SYSTEM_LINKED 0x400000 |
Menunjukkan bahwa objek diformat sebagai hyperlink. Peran objek biasanya akan ROLE_SYSTEM_TEXT. |
|
STATE_SYSTEM_MARQUEED 0x2000 |
Menunjukkan pengguliran atau pemindahan teks atau grafik. |
|
STATE_SYSTEM_MIXED 0x20 |
Menunjukkan bahwa status kotak centang tiga status atau tombol toolbar tidak ditentukan. Kotak centang tidak dipilih atau dikosongkan dan oleh karena itu dalam status campuran ketiga atau |
|
STATE_SYSTEM_MOVEABLE 0x40000 |
Menunjukkan bahwa objek dapat dipindahkan. Misalnya, pengguna dapat mengklik bilah judul objek dan menyeret objek ke lokasi baru. |
|
STATE_SYSTEM_MULTISELECTABLE 0x1000000 |
Menunjukkan bahwa objek menerima beberapa item yang dipilih; artinya, SELFLAG_ADDSELECTION untuk metode IAccessible::accSelect valid. |
|
STATE_SYSTEM_NORMAL 0 |
Menunjukkan bahwa objek tidak memiliki status lain yang ditetapkan untuk objek tersebut. |
|
STATE_SYSTEM_OFFSCREEN 0x10000 |
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. |
|
STATE_SYSTEM_PRESSED 0x8 |
Objek ditekan. |
|
STATE_SYSTEM_PROTECTED 0x20000000 |
Objek adalah kontrol edit yang dilindungi kata sandi. |
|
STATE_SYSTEM_READONLY 0x40 |
Objek ditunjuk baca-saja. |
|
STATE_SYSTEM_SELECTABLE 0x200000 |
Objek menerima pilihan. |
|
STATE_SYSTEM_SELECTED 0x2 |
Objek dipilih. |
|
STATE_SYSTEM_SELFVOICING 0x80000 |
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. |
|
STATE_SYSTEM_SIZEABLE 0x20000 |
Objek dapat diubah ukurannya. Misalnya, pengguna dapat mengubah ukuran jendela dengan menyeretnya berdasarkan batas. |
|
STATE_SYSTEM_TRAVERSED 0x800000 |
Objek adalah hyperlink yang telah dikunjungi (sebelumnya diklik) oleh pengguna. |
|
STATE_SYSTEM_UNAVAILABLE 0x1 |
Objek tidak tersedia. |
Persyaratan
| Syarat | Nilai |
|---|---|
| Header |
Oleacc.h |