Tipe Kontrol ListItem
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 Automation UI yang diperlukan untuk jenis kontrol ListItem . Persyaratan Otomatisasi 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
- Keterangan
- 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 bisa dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Ringkasan Pohon UI Automation.
Tampilan Kontrol | Tampilan Konten |
---|---|
|
|
Turunan dari kontrol item daftar dalam tampilan konten pohon Automation UI harus selalu menampilkan nol turunan. 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 Otomatisasi UI, lihat Mengambil Properti dari Elemen Automasi UI.
Properti UI Automation | 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 gambar dan konten teks dari item daftar. |
UIA_ClickablePointPropertyId | Bergantung | Jika kontrol daftar memiliki titik yang dapat diklik (titik yang dapat diklik untuk menyebabkan daftar mengambil 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 tooltip. Misalnya, "Pilih item untuk mengatur resolusi tampilan untuk monitor Anda". |
UIA_IsContentElementPropertyId | TRUE | Kontrol daftar selalu disertakan dalam tampilan konten pohon UI Automation. |
UIA_IsControlElementPropertyId | TRUE | Kontrol daftar selalu disertakan dalam tampilan kontrol pohon UI Automation. |
UIA_IsKeyboardFocusablePropertyId | Lihat catatan. | Jika kontainer dapat menerima input keyboard, nilai properti ini harus TRUE. |
UIA_IsOffscreenPropertyId | Bergantung | Properti ini harus mengembalikan nilai untuk apakah item daftar saat ini digulir ke tampilan dalam kontainer induk yang mengimplementasikan pola kontrol Gulir . |
UIA_ItemStatusPropertyId | Bergantung | Jika kontrol berisi status yang sedang diperbarui secara dinamis, properti ini harus didukung sehingga teknologi bantuan dapat menerima pembaruan ketika status elemen berubah. |
UIA_ItemTypePropertyId | Bergantung | Properti ini harus diekspos untuk kontrol item daftar yang mewakili objek yang mendasarinya. Kontrol item daftar ini biasanya memiliki ikon yang terkait dengan kontrol yang dikaitkan pengguna dengan objek yang mendasarinya. |
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 English (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 Otomatisasi UI yang diperlukan untuk didukung oleh semua kontrol item daftar. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.
Pola Kontrol | Dukungan | Catatan |
---|---|---|
IExpandCollapseProvider | Bergantung | Jika item dapat dimanipulasi untuk menampilkan atau menyembunyikan informasi, pola kontrol ExpandCollapse harus diimplementasikan. |
IGridItemProvider | Bergantung | Jika navigasi spasial item-ke-item didukung dalam kontainer daftar, dan kontainer disusun dalam baris dan kolom, pola kontrol GridItem harus diimplementasikan. |
IInvokeProvider | Bergantung | Jika item memiliki perintah yang dapat dilakukan di atasnya, terpisah dari pilihan, pola Kontrol pemanggilan 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 Pemutar Media Windows. |
IScrollItemProvider | Bergantung | Jika item daftar terkandung dalam kontainer yang dapat digulir, pola kontrol ScrollItem harus diimplementasikan. |
ISelectionItemProvider | Bergantung | Kontrol item daftar yang mendukung pilihan harus mengimplementasikan pola kontrol SelectionItem . Ini memungkinkan kontrol item daftar untuk disampaikan saat dipilih. |
IToggleProvider | Bergantung | Jika item daftar dapat diperiksa dan tindakan tidak melakukan perubahan status pilihan, pola kontrol Alihkan harus diimplementasikan. |
IValueProvider | Bergantung | 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 ini mencantumkan peristiwa Automasi UI yang diperlukan untuk mendukung kontrol item daftar. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
Peristiwa UI Automation | 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 pemanggilan , kontrol harus mendukung peristiwa ini. |
UIA_IsEnabledPropertyId peristiwa yang diubah properti. | Jika kontrol mendukung properti IsEnabled , kontrol harus mendukung peristiwa ini. |
UIA_IsOffscreenPropertyId peristiwa yang diubah properti. | Jika kontrol mendukung properti IsOffscreen , kontrol harus mendukung peristiwa ini. |
UIA_ItemStatusPropertyId peristiwa yang diubah properti. | Jika kontrol mendukung properti ItemStatus , harus mendukung kejadian ini. |
UIA_NamePropertyId peristiwa yang diubah properti. | |
UIA_SelectionItem_ElementAddedToSelectionEventId | Jika kontrol mendukung pola kontrol SelectionItem , kontrol harus mendukung kejadian ini. |
UIA_SelectionItem_ElementRemovedFromSelectionEventId | Jika kontrol mendukung pola kontrol SelectionItem , kontrol harus mendukung kejadian ini. |
UIA_SelectionItem_ElementSelectedEventId | Jika kontrol mendukung pola kontrol SelectionItem , kontrol harus mendukung kejadian ini. |
UIA_StructureChangedEventId | |
UIA_ToggleToggleStatePropertyId peristiwa yang diubah properti. | Jika kontrol mendukung pola kontrol Hidupkan/Matikan , kontrol harus mendukung kejadian ini. |
UIA_ValueValuePropertyId peristiwa yang diubah properti. | Jika kontrol mendukung pola kontrol Nilai , kontrol harus mendukung peristiwa ini. |
Keterangan
Jika kontainer menghosting item daftar, sarana navigasi utama harus masuk ke item daftar. Menempatkan fokus pada sublemen melalui navigasi daftar dapat membingungkan 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk