Bagikan melalui

Kotak Kombo (Referensi Elemen UI MSAA)

  • Artikel

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_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 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_accDescription

  • get_accFocus

  • get_accHelp

  • get_accHelpTopic

  • 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.

    Bagian kotak kombo Parent
    Jendela kotak kombo Jendela dengan properti Peran ROLE_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 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.

Antarmuka IAccessible