Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Topik ini menyediakan informasi tentang dukungan Microsoft UI Automation untuk jenis kontrol ListItem.
Kontrol item daftar adalah contoh kontrol yang mengimplementasikan jenis kontrol ListItem.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Otomasi UI yang diperlukan untuk jenis kontrol ListItem. Persyaratan Automasi UI berlaku untuk semua kontrol item daftar tempat kerangka kerja/platform UI mengintegrasikan dukungan Automation UI untuk jenis kontrol dan pola kontrol.
Topik ini berisi bagian berikut.
- Struktur Pohon Umum
- properti yang relevan
- Pola Kontrol yang Diperlukan
- Peristiwa yang Diperlukan
- Komentar
- Topik terkait
Struktur Pohon Umum
Tabel berikut ini menggambarkan kontrol umum dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol item daftar dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon Automation UI, lihat Gambaran Umum Pohon Automasi UI .
| Tampilan Kontrol | Tampilan Isi |
|---|---|
|
|
Turunan dari kontrol item daftar dalam tampilan konten pohon Automation UI harus selalu menampilkan nol anak. Jika struktur kontrol sedih sehingga item lain terkandung di bawah item daftar, maka harus mengikuti persyaratan untuk dukungan Automation UI untuk jenis kontrol TreeItem.
Properti yang Relevan
Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan jenis kontrol ListItem. Untuk informasi selengkapnya tentang properti Automation UI, lihat Mengambil Properti dari Elemen Automation UI.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| UIA_AutomationIdPropertyId | Lihat catatan. | Nilai properti ini harus unik di antara semua elemen serekan dalam tampilan mentah pohon Automation UI. Alokasikan properti AutomationId untuk item daftar jika elemen diketahui konsisten di berbagai instans antarmuka pengguna. Jika item daftar diisi secara dinamis dan tidak dapat diprediksi, biarkan properti AutomationId kosong. |
| UIA_BoundingRectanglePropertyId | Lihat catatan. | Nilai properti ini harus mencakup area isi gambar dan teks item daftar. |
| UIA_ClickablePointPropertyId | Tergantung | Jika kontrol daftar memiliki titik yang dapat diklik (titik yang dapat diklik untuk menyebabkan daftar menjadi fokus), titik tersebut harus diekspos melalui properti ini. Jika kontrol daftar sepenuhnya dicakup oleh item daftar turunan, itu akan mengembalikan kesalahan UIA_E_NOCLICKABLEPOINT untuk menunjukkan bahwa klien harus meminta item di dalam kontrol daftar untuk titik yang dapat diklik. |
| UIA_ControlTypePropertyId | ListItem | Nilai ini sama untuk semua kerangka kerja UI. |
| UIA_HelpTextPropertyId | Lihat catatan. | Teks Bantuan untuk kontrol daftar harus menjelaskan mengapa pengguna diminta untuk membuat pilihan dari daftar opsi, yang biasanya merupakan jenis informasi yang sama yang disajikan melalui tipsalat. Misalnya, "Pilih item untuk mengatur resolusi tampilan untuk monitor Anda". |
| UIA_IsContentElementPropertyId | TRUE | Kontrol daftar selalu disertakan dalam tampilan konten pohon Automation UI. |
| UIA_IsControlElementPropertyId | TRUE | Kontrol daftar selalu disertakan dalam tampilan kontrol pohon Automation UI. |
| UIA_IsKeyboardFocusablePropertyId | Lihat catatan. | Jika kontainer dapat menerima input keyboard, maka nilai properti ini harus TRUE. |
| UIA_IsOffscreenPropertyId | Tergantung | Properti ini harus mengembalikan nilai untuk apakah item daftar saat ini digulir ke tampilan dalam kontainer induk yang mengimplementasikan pola kontrol Scroll. |
| UIA_ItemStatusPropertyId | Tergantung | Jika kontrol berisi status yang sedang diperbarui secara dinamis, properti ini harus didukung sehingga teknologi bantuan dapat menerima pembaruan saat status elemen berubah. |
| UIA_ItemTypePropertyId | Tergantung | Properti ini harus diekspos untuk kontrol item daftar yang mewakili objek yang mendasar. Kontrol item daftar ini biasanya memiliki ikon yang terkait dengan kontrol yang dikaitkan pengguna dengan objek yang mendasar. |
| UIA_LabeledByPropertyId | Lihat catatan. | Jika ada label teks statis, maka properti ini harus mengekspos referensi ke kontrol tersebut. |
| UIA_LocalizedControlTypePropertyId | Lihat catatan. | String yang dilokalkan sesuai dengan jenis kontrol ListItem. Nilai defaultnya adalah "item daftar" untuk en-US atau Inggris (Amerika Serikat). |
| UIA_NamePropertyId | Lihat catatan. | Nilai properti nama kontrol item daftar berasal dari label teks item. |
Pola Kontrol yang Diperlukan
Tabel berikut mencantumkan pola kontrol Automation UI yang diperlukan untuk didukung oleh semua kontrol item daftar. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI .
| Pola Kontrol | Dukung | Catatan |
|---|---|---|
| IExpandCollapseProvider | Tergantung | Jika item dapat dimanipulasi untuk menampilkan atau menyembunyikan informasi, pola kontrol ExpandCollapse harus diimplementasikan. |
| IGridItemProvider | Tergantung | Jika navigasi spasial item-ke-item didukung dalam kontainer daftar, dan kontainer diatur dalam baris dan kolom, pola kontrol GridItem harus diimplementasikan. |
| IInvokeProvider | Tergantung | Jika item memiliki perintah yang dapat dilakukan di atasnya, terpisah dari pilihan, pola kontrol Invoke harus diimplementasikan. Ini biasanya merupakan tindakan yang terkait dengan mengklik dua kali kontrol item daftar. Contohnya adalah meluncurkan dokumen dari Windows Explorer, atau memutar file musik di Microsoft Windows Media Player. |
| IScrollItemProvider | Tergantung | Jika item daftar terkandung dalam kontainer yang dapat digulir, pola kontrol ScrollItem harus diimplementasikan. |
| ISelectionItemProvider | Tergantung | Kontrol item daftar yang mendukung pilihan harus menerapkan pola kontrol SelectionItem. Ini memungkinkan kontrol item daftar untuk disampaikan ketika dipilih. |
| IToggleProvider | Tergantung | Jika item daftar dapat dicentang dan tindakan tidak melakukan perubahan status pilihan, pola kontrol Bolak- harus diimplementasikan. |
| IValueProvider | Tergantung | Jika item dapat diedit, pola kontrol Nilai harus diimplementasikan. Perubahan pada kontrol item daftar akan menyebabkan perubahan pada nilai properti UIA_NamePropertyId dan UIA_ValueValuePropertyId. |
Peristiwa yang Diperlukan
Tabel berikut mencantumkan peristiwa Automation UI yang diperlukan kontrol item daftar untuk didukung. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .
| Peristiwa Automasi UI | Catatan |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId peristiwa yang diubah properti. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId peristiwa yang diubah properti. | Jika kontrol mendukung pola kontrol ExpandCollapse, kontrol harus mendukung peristiwa ini. |
| UIA_Invoke_InvokedEventId | Jika kontrol mendukung pola kontrol Invoke, kontrol harus mendukung peristiwa ini. |
| UIA_IsEnabledPropertyId peristiwa yang diubah properti. | Jika kontrol mendukung propertiIsEnabled, kontrol harus mendukung peristiwa ini. |
| UIA_IsOffscreenPropertyId peristiwa yang diubah properti. | Jika kontrol mendukung propertiIsOffscreen, kontrol harus mendukung peristiwa ini. |
| UIA_ItemStatusPropertyId peristiwa yang diubah properti. | Jika kontrol mendukung properti ItemStatus, harus mendukung peristiwa ini. |
| UIA_NamePropertyId peristiwa yang diubah properti. | |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Jika kontrol mendukung pola kontrol SelectionItem, kontrol harus mendukung peristiwa ini. |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Jika kontrol mendukung pola kontrol SelectionItem, kontrol harus mendukung peristiwa ini. |
| UIA_SelectionItem_ElementSelectedEventId | Jika kontrol mendukung pola kontrol SelectionItem, kontrol harus mendukung peristiwa ini. |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId peristiwa yang diubah properti. | Jika kontrol mendukung pola kontrol Toggle, kontrol harus mendukung peristiwa ini. |
| UIA_ValueValuePropertyId peristiwa yang diubah properti. | Jika kontrol mendukung pola kontrol Nilai, kontrol harus mendukung peristiwa ini. |
Komentar
Jika kontainer menghosting item daftar, sarana navigasi utama harus masuk ke item daftar. Menempatkan fokus pada subelemen melalui navigasi daftar dapat membingungkan bagi pengguna dan alat aksesibilitas. Jika kontainer menghosting daftar item vertikal, menekan tombol PANAH ATAS dan PANAH BAWAH harus menavigasi item, tetapi menekan tombol PANAH KANAN dan PANAH KIRI dapat menavigasi ke subelemen item yang difokuskan, seperti kolom daftar atau subelemen UI.
Topik terkait
-
Konseptual