List-View Control (Referensi Elemen MSAA UI)
Nota
Topik ini menjelaskan List-View Kontrol objek untuk tujuan Referensi Elemen UI MSAA. Cara membuat List-View Control objek dalam 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 metodeIAccessible berikut:
| Metode | Komentar |
|---|---|
| accDoDefaultAction | Objek tampilan daftar itu sendiri tidak memiliki properti DefaultAction; namun, metodeaccDoDefaultActionmengklik dua kali item tampilan daftar. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accPilih |
Properti IAccessible
Kontrol tampilan daftar mendukung propertiIAccessible berikut ini:
| Harta benda | 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 item tampilan daftar adalah objek tampilan daftar. |
| get_accRole | PeranROLE_SYSTEM_LIST, dan setiap item dalam kontrol tampilan daftar memiliki properti PeranROLE_SYSTEM_LISTITEM. |
| get_accSelection | |
| get_accState | Properti Status dari objek tampilan daftar adalah kombinasi dari satu atau beberapa nilai berikut ini: 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: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_OFFSCREEN | 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 set 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 fungsiAccessibleObjectFromPoint untuk masuk ke kontrol header.
- Untuk objek non-persegi panjang seperti item tampilan daftar dalam tampilan Detail, koordinat persegi panjang batas item yang diambil oleh accLocation gagal jika diuji dengan accHitTest karena accHitTest menentukan batas objek berdasarkan piksel demi piksel.