Bagikan melalui

Kontrol Tampilan Daftar (Referensi Elemen UI MSAA)

  • Artikel

Catatan

Topik ini menjelaskan objek Kontrol Tampilan Daftar untuk tujuan Referensi Elemen UI MSAA. Cara membuat objek Kontrol Tampilan Daftar di berbagai kerangka kerja UI tidak dijelaskan di sini. Lihat dokumentasi referensi API untuk kerangka kerja UI yang Anda gunakan.

Kontrol tampilan daftar menampilkan kumpulan item, masing-masing terdiri dari ikon dan label, dan menyediakan beberapa cara untuk menampilkan dan menyusun item. Misalnya, informasi tambahan tentang setiap item ditampilkan dalam kolom di sebelah kanan ikon dan label. Windows Explorer menggunakan kontrol tampilan daftar untuk menampilkan file.

Nama kelas jendela untuk kontrol tampilan daftar WC_LISTVIEW, yang didefinisikan sebagai "SysListView" di Commctrl.h.

Metode IAccessible

Kontrol tampilan daftar mendukung metode IAccessible berikut:

Metode Komentar
accDoDefaultAction Objek tampilan daftar itu sendiri tidak memiliki properti DefaultAction; namun, metode accDoDefaultAction mengklik dua kali item tampilan daftar.
accHitTest
accLocation
accNavigate
accSelect

Properti IAccessible

Kontrol tampilan daftar mendukung properti IAccessible berikut:

Properti Komentar
get_accChild
get_accChildCount Properti ChildCount adalah jumlah item dalam daftar.
get_accDefaultAction Objek tampilan daftar itu sendiri tidak memiliki properti DefaultAction ; namun, properti DefaultAction untuk setiap item tampilan daftar adalah "Klik Ganda".
get_accDescription Objek tampilan daftar itu sendiri tidak mendukung properti Deskripsi ; namun, properti Deskripsi untuk setiap item tampilan daftar adalah teks yang terkandung dalam kolom kedua dan berikutnya item. Koma disisipkan di antara teks untuk setiap kolom.
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut Objek tampilan daftar tidak memiliki pintasan keyboard. Namun, jika teks jendela untuk kontrol tampilan daftar berisi karakter ampersand (&), Microsoft Active Accessibility mengembalikan string non-Null sebagai properti KeyboardShortcut .
get_accName Nama untuk objek tampilan daftar diperoleh dari teks jendela kontrol (atau keterangan). Teks ini tidak ditampilkan dengan kontrol tampilan daftar, sehingga pengembang server harus menyediakan teks yang bermakna dalam pernyataan definisi sumber daya kontrol untuk membantu pengguna utilitas klien mengidentifikasi kontrol. Untuk item tampilan daftar, properti Nama adalah teks item daftar.
get_accParent Induk objek tampilan daftar adalah jendela ( ROLE_SYSTEM_WINDOW ) yang mengelilingi kontrol dan memiliki properti Nama dan nama kelas jendela yang sama dengan kontrol. Properti Induk dari item tampilan daftar adalah objek tampilan daftar.
get_accRole Peran ROLE_SYSTEM_LIST, dan setiap item dalam kontrol tampilan daftar memiliki properti Peran ROLE_SYSTEM_LISTITEM.
get_accSelection
get_accState Properti Status objek tampilan daftar adalah kombinasi dari satu atau beberapa nilai berikut: STATE_SYSTEM_INVISIBLE STATE_SYSTEM_UNAVAILABLE | | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_OFFSCREEN |
Properti Status dari item tampilan daftar adalah kombinasi dari satu atau beberapa nilai berikut ini:
| | | STATE_SYSTEM_INVISIBLE STATE_SYSTEM_NORMAL STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_MULTISELECTABLE | | STATE_SYSTEM_SELECTED | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_HOTTRACKED STATE_SYSTEM_HOTTRACKED STATE_SYSTEM_OFFSCREEN | STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_FOCUSED STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_NORMAL
Selain itu, kotak centang item tampilan daftar juga memiliki status STATE_SYSTEM_CHECKED.

Catatan

  • Microsoft Active Accessibility tidak mengekspos teks item tampilan daftar dalam aplikasi yang menggunakan fungsi panggilan balik untuk menambahkan teks ke item.
  • Item tampilan daftar yang diklip tidak memiliki kumpulan STATE_SYSTEM_INVISIBLE. Untuk menentukan apakah item daftar diklip, klien dapat membandingkan koordinat item yang dikembalikan oleh accLocation dengan wilayah kliping jendela.
  • Microsoft Active Accessibility tidak mendukung penggunaan metode accNavigate untuk menavigasi ke kontrol header dalam kontrol tampilan daftar yang ada dalam tampilan Detail. Namun, klien menggunakan fungsi AccessibleObjectFromPoint untuk masuk ke kontrol header.
  • Untuk objek non-persegi panjang seperti item tampilan daftar dalam tampilan Detail, koordinat persegi panjang pembatas item yang diambil oleh accLocation gagal jika diuji dengan accHitTest karena accHitTest menentukan batas objek berdasarkan piksel demi piksel.

Antarmuka IAccessible