Kotak Kombo (Referensi Elemen UI MSAA)
Catatan
Topik ini menjelaskan objek Combo Box untuk tujuan Referensi Elemen UI MSAA. Cara membuat objek Combo Box di berbagai kerangka kerja UI tidak dijelaskan di sini. Lihat dokumentasi referensi API untuk kerangka kerja UI yang Anda gunakan.
Kotak kombo adalah kotak daftar yang dikombinasikan dengan kontrol statis atau kontrol edit yang menampilkan item yang saat ini dipilih di bagian kotak daftar kotak kombo. Bagian kotak daftar kontrol ditampilkan setiap saat atau hanya turun bawah saat pengguna memilih panah drop-down (yang merupakan tombol dorong) di samping kontrol. Jika bidang pilihan adalah kontrol edit, pengguna dapat memasukkan informasi yang tidak ada dalam daftar; jika tidak, pengguna hanya dapat memilih item dalam daftar.
Nama kelas jendela untuk kotak kombo adalah "COMBOBOX".
Konten properti IAccessible bergantung pada bagian mana dari kotak kombo berikut yang dikueri oleh klien:
- Jendela kotak kombo
- Kontrol edit atau kontrol teks statis
- Panah drop-down (yang merupakan tombol dorong)
- Kotak daftar
- Item daftar dalam kotak daftar
Metode IAccessible
Kotak kombo mendukung metode IAccessible berikut:
Properti IAccessible
Kotak kombo mendukung properti IAccessible berikut:
get_accChildCount—Tabel berikut ini memperlihatkan nilai jumlah anak untuk berbagai bagian kotak kombo.
Bagian kotak kombo ChildCount Jendela kotak kombo 3 Edit kontrol 0 Panah turun bawah 0 Kotak daftar Jumlah item daftar Item daftar 0 get_accDefaultAction—Tabel berikut ini memperlihatkan properti DefaultAction untuk bagian kotak kombo yang berbeda.
Bagian kotak kombo DefaultAction Jendela kotak kombo Tidak ada Edit kontrol Tidak ada Panah turun bawah "Buka" atau "Tutup" tergantung pada status daftar drop-down Kotak daftar Tidak ada Item daftar "Klik Ganda" get_accKeyboardShortcut—Tabel berikut ini memperlihatkan properti KeyboardShortcut untuk bagian kotak kombo yang berbeda.
Bagian kotak kombo KeyboardShortcut Jendela kotak kombo Kunci akses label terkait Edit kontrol Tidak ada Panah turun bawah "Alt+Panah Bawah" Kotak daftar Tidak ada Item daftar Tidak ada Kunci akses untuk kotak kombo adalah karakter bergaris bawah dalam teks dari kontrol teks statis terkait yang melabeli kotak kombo. Misalnya, pada kotak dialog Buka standar yang membuka file, seperti di Microsoft WordPad, kotak kombo berlabel "File jenis:" memiliki KeyboardShortcut "Alt+t".
get_accName—Tabel berikut ini memperlihatkan properti Nama untuk bagian kotak kombo yang berbeda.
Bagian kotak kombo Nama Jendela kotak kombo Kontrol teks statis yang digunakan sebagai label Edit kontrol Kontrol teks statis yang digunakan sebagai label Panah turun bawah "Buka" atau "Tutup" tergantung pada status daftar drop-down Kotak daftar Label terkait Item daftar Teks item daftar Properti Nama kotak kombo, kontrol edit turunannya, dan kotak daftar turunannya adalah teks dari kontrol teks statis terkait yang melabeli kotak kombo. Misalnya, pada kotak dialog Buka standar yang membuka file, seperti di WordPad, properti Nama untuk dua kotak kombo adalah "Look in:" dan "Files of type:".
get_accParent—Tabel berikut ini memperlihatkan nilai induk untuk bagian kotak kombo yang berbeda.
get_accRole—Tabel berikut ini memperlihatkan properti Peran untuk bagian kotak kombo yang berbeda.
Bagian kotak kombo Peran Jendela kotak kombo ROLE_SYSTEM_COMBOBOX Edit kontrol (atau kontrol teks statis) ROLE_SYSTEM_TEXT atau ROLE_SYSTEM_STATICTEXT Panah turun bawah ROLE_SYSTEM_PUSHBUTTON Kotak daftar ROLE_SYSTEM_LIST Item daftar ROLE_SYSTEM_LISTITEM get_accState—Tabel berikut ini memperlihatkan properti Status untuk bagian kotak kombo yang berbeda.
Bagian kotak kombo Kemungkinan status Jendela kotak kombo | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_NORMAL | STATE_SYSTEM_EXPANDED STATE_SYSTEM_COLLAPSED Edit kontrol | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_NORMAL Panah turun bawah 0, yang berarti tombol terlihat dan tidak ditekan; atau STATE_SYSTEM_INVISIBLE STATE_SYSTEM_PRESSED | | STATE_SYSTEM_NORMAL Kotak daftar | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FLOATING STATE_SYSTEM_NORMAL Item daftar | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED STATE_SYSTEM_NORMAL get_accValue—Tabel berikut ini memperlihatkan properti Nilai untuk bagian kotak kombo yang berbeda.
Bagian kotak kombo Nilai Jendela kotak kombo Teks item daftar yang saat ini dipilih Edit kontrol Teks item daftar yang saat ini dipilih Panah turun bawah Tidak ada Kotak daftar Tidak ada Item daftar Tidak ada
Catatan
- Ketika accNavigate dipanggil dengan bendera NAVDIR_NEXT pada bagian kotak daftar dari kotak kombo, itu salah menavigasi ke jendela baki ketika harus mengembalikan VT_EMPTY.
Topik terkait