Kotak Kombo (Referensi Elemen MSAA UI)

Nota

Topik ini menjelaskan objek Combo Box untuk tujuan Referensi Elemen MSAA UI. Cara membuat objek Combo Box dalam 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 dalam 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 tekan) 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 propertiIAccessible bergantung pada bagian kotak kombo mana yang dikueri oleh klien:

• Jendela kotak kombo
• Kontrol edit atau kontrol teks statis
• Panah drop-down (yang merupakan tombol tekan)
• Kotak daftar
• Item daftar dalam kotak daftar

Metode IAccessible

Kotak kombo mendukung metodeIAccessible berikut:

• accDoDefaultAction
• accHitTest
• accLocation
• accNavigate
• accPilih

Properti IAccessible

Kotak kombo mendukung propertiIAccessible berikut:

• get_accChild

• 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 berbagai bagian kotak kombo.

  Bagian kotak kombo	DefaultAction
  Jendela kotak kombo	Tidak
  Edit kontrol	Tidak
  Panah turun bawah	"Buka" atau "Tutup" tergantung pada status daftar drop-down
  Kotak daftar	Tidak
  Item daftar	"Klik Ganda"

   

• get_accDescription

• get_accFocus

• get_accHelp

• get_accHelpTopic

• get_accKeyboardShortcut—Tabel berikut ini memperlihatkan properti KeyboardShortcut untuk berbagai bagian kotak kombo.

  Bagian kotak kombo	KeyboardShortcut
  Jendela kotak kombo	Kunci akses label terkait
  Edit kontrol	Tidak
  Panah turun bawah	"Alt+Panah Bawah"
  Kotak daftar	Tidak
  Item daftar	Tidak

   

  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 berbagai bagian kotak kombo.

  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, Nama properti untuk dua kotak kombo adalah "Look in:" dan "Files of type:".

• get_accParent—Tabel berikut ini memperlihatkan nilai induk untuk berbagai bagian kotak kombo.

  Bagian kotak kombo	Ortu
  Jendela kotak kombo	Jendela dengan properti PeranROLE_SYSTEM_WINDOW yang mengelilingi kotak kombo dan memiliki properti Nama dan nama kelas jendela yang sama dengan kotak kombo.
  Edit kontrol (atau kontrol teks statis)	Jendela kotak kombo.
  Panah turun bawah	Jendela kotak kombo.
  Jendela induk kotak daftar	Jendela kotak kombo. Jendela ini mengelilingi kotak daftar.
  Kotak daftar	Jendela induk kotak daftar.
  Item daftar	Kotak daftar.

   

• get_accRole—Tabel berikut ini memperlihatkan properti Peran untuk berbagai bagian kotak kombo.

  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 berbagai bagian kotak kombo.

  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_PRESSED | STATE_SYSTEM_INVISIBLE | 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 berbagai bagian kotak kombo.

  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
  Kotak daftar	Tidak
  Item daftar	Tidak

   

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

Antarmuka IAccessible