Dukungan UI Automation untuk Jenis Kontrol ListItem
Catatan
Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas UI Automation terkelola yang ditentukan pada namespace System.Windows.Automation. Untuk informasi terbaru tentang UI Automation, lihat API Automasi Windows: Automasi Antarmuka Pengguna.
Topik ini memberikan informasi tentang dukungan UI Automation untuk jenis kontrol ListItem. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti dan pola kontrol UI Automation.
Kontrol item daftar adalah contoh kontrol yang mengimplementasikan jenis kontrol ListItem.
Bagian berikut mendefinisikan struktur pohon, properti, pola kontrol, dan peristiwa UI Automation yang diperlukan untuk jenis kontrol ListItem. Persyaratan UI Automation berlaku untuk semua kontrol daftar, baik Windows Presentation Foundation (WPF), Win32, atau Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten dari pohon UI Automation yang berkaitan dengan kontrol item daftar dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| ListItem - Image (0 atau lebih) - Teks (0 atau lebih) - Edit (0 atau lebih) |
ListItem |
Turunan dari kontrol item daftar dalam tampilan konten pohon UI Automation harus selalu "0". Jika struktur kontrol sedemikian rupa sehingga item lain terdapat di bawah item daftar, maka kontrol harus mengikuti persyaratan untuk jenis kontrol Dukungan UI Automation untuk Jenis Kontrol TreeItem.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol item daftar. Untuk informasi selengkapnya tentang properti UI Automation, lihat Properti UI Automation untuk Klien.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| AutomationIdProperty | Lihat catatan. | Nilai properti ini harus unik di semua kontrol dalam aplikasi. |
| BoundingRectangleProperty | Lihat catatan. | Nilai properti ini harus mencakup area gambar dan konten teks dari item daftar. |
| ClickablePointProperty | Bergantung | Jika kontrol daftar memiliki titik yang dapat diklik (titik yang dapat diklik untuk menyebabkan daftar menjadi terfokus), maka titik tersebut harus diekspos melalui properti ini. Jika kontrol daftar sepenuhnya dicakup oleh item daftar keturunan, ini akan memunculkan NoClickablePointException untuk menunjukkan bahwa klien harus meminta item di dalam kontrol daftar untuk titik yang dapat diklik. |
| NameProperty | Lihat catatan. | Nilai properti nama kontrol item daftar berasal dari konten teks item. |
| LabeledByProperty | Lihat catatan. | Jika ada label teks statik, properti ini harus mengekspos referensi ke kontrol tersebut. |
| ControlTypeProperty | ListItem | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "list item" | String yang dilokalkan sesuai dengan jenis kontrol ListItem. |
| IsContentElementProperty | Benar | Kontrol daftar selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsControlElementProperty | Benar | Kontrol daftar selalu disertakan dalam tampilan kontrol pohon UI Automation. |
| IsKeyboardFocusableProperty | Benar | Jika kontainer dapat menerima input keyboard maka nilai properti ini harus true. |
| HelpTextProperty | "" | 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 monitor Anda". |
| ItemTypeProperty | 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. |
| IsOffscreenProperty | Bergantung | Properti ini harus mengembalikan nilai untuk apakah item daftar saat ini digulir ke tampilan dalam kontainer induk yang mengimplementasikan pola kontrol Gulir. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang perlu didukung oleh kontrol item daftar. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| ISelectionItemProvider | Ya | Kontrol item daftar harus mengimplementasikan pola kontrol ini. Ini memungkinkan kontrol item daftar untuk disampaikan saat dipilih. |
| IScrollItemProvider | Bergantung | Jika item daftar termuat dalam kontainer yang dapat digulir, maka pola kontrol ini harus diimplementasikan. |
| IToggleProvider | Bergantung | Jika item daftar dapat dicentang dan tindakan tidak melakukan perubahan status pemilihan, maka pola kontrol ini harus diimplementasikan. |
| IExpandCollapseProvider | Bergantung | Jika item dapat dimanipulasi untuk menampilkan atau menyembunyikan informasi maka pola kontrol ini harus diimplementasikan. |
| IValueProvider | Bergantung | Jika item dapat diedit maka pola kontrol ini harus diimplementasikan. Perubahan pada kontrol item daftar akan menyebabkan perubahan pada nilai NameProperty, dan Value. |
| IGridItemProvider | Bergantung | Jika navigasi spasial item ke item didukung dalam kontainer daftar dan kontainer diatur dalam baris dan kolom, maka pola kontrol Item Kisi harus diimplementasikan. |
| IInvokeProvider | Bergantung | Jika item memiliki perintah yang dapat dilakukan pada item tersebut, selain pemilihan, maka pola ini harus diimplementasikan. Ini biasanya merupakan tindakan yang terkait dengan mengklik dua kali kontrol item daftar. Contohnya akan meluncurkan dokumen dari Microsoft Windows Explorer, atau memutar file musik di Microsoft Windows Media Player. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang perlu didukung oleh semua kontrol item daftar. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| InvokedEvent | Bergantung | Tidak |
| ElementAddedToSelectionEvent | Wajib | Tidak |
| ElementRemovedFromSelectionEvent | Wajib | Tidak |
| ElementSelectedEvent | Wajib | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| NameProperty | Wajib | Tidak |
| ItemStatusProperty peristiwa perubahan properti. | Bergantung | Tidak |
| ExpandCollapseStateProperty peristiwa perubahan properti. | Bergantung | Tidak |
| ValueProperty peristiwa perubahan properti. | Bergantung | Tidak |
| ToggleStateProperty peristiwa perubahan properti. | Bergantung | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |