Dukungan UI Automation untuk Jenis Kontrol TreeItem
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 TreeItem. 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.
Jenis kontrol TreeItem mewakili node dalam kontainer pohon. Setiap node dapat memuat node lain, yang disebut node anak. Node induk, atau node yang memuat node anak, dapat ditampilkan sebagai diperluas atau diciutkan.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan peristiwa untuk jenis kontrol TreeItem. Persyaratan UI Automation berlaku untuk semua kontrol item pohon, baik Windows Presentation Foundation (WPF), Win32, maupun 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 pohon dan menjelaskan hal yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| TreeItem - Kotak Centang (0 atau 1) - Gambar (0 atau 1) - Tombol (0 atau 1) - TreeItem (0 atau lebih) |
TreeItem - TreeItem (0 atau lebih) |
Kontrol item pohon dapat memiliki anak item pohon nol atau lebih dalam tampilan konten pohon UI Automation. Jika kontrol item pohon memiliki fungsi di luar yang diekspos dalam pola kontrol yang tercantum di bawah, maka kontrol harus didasarkan pada jenis kontrol Item Data.
Item pohon yang diciutkan tidak akan ditampilkan dalam tampilan kontrol atau tampilan konten hingga menjadi diperluas dan terlihat (atau, dapat digulir ke tampilan).
Tampilan kontrol dapat memuat rincian tambahan untuk kontrol, termasuk gambar atau tombol terkait. Contohnya, item dalam tampilan kerangka dapat memuat gambar serta tombol untuk memperluas atau menciutkan kerangka. Objek rincian ini tidak muncul dalam tampilan konten karena informasi sudah diwakili oleh item pohon induk. Item pohon yang digulir dari layar akan muncul dalam tampilan kontrol maupun tampilan konten dari pohon UI Automation dan harus diatur IsOffscreenProperty ke true.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol 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. | Persegi terluar yang berisi seluruh kontrol. |
| ClickablePointProperty | Lihat catatan. | Properti ini harus mengembalikan lokasi item yang akan menyebabkan item mengubah status pilihan atau menjadi fokus. |
| ControlTypeProperty | TreeItem | Nilai ini sama untuk semua kerangka kerja UI. |
| IsContentElementProperty | Benar | Kontrol daftar selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsControlElementProperty | Benar | Kontrol daftar selalu disertakan dalam tampilan kontrol pohon UI Automation. |
| IsOffscreenProperty | Lihat catatan. | Properti ini diatur untuk menunjukkan waktu kontrol item pohon digulir dari layar. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| ItemTypeProperty | Lihat catatan. | Jika kontrol item pohon menggunakan ikon visual untuk menunjukkan bahwa ikon tersebut adalah jenis objek tertentu, maka properti ini harus didukung dan menunjukkan definisi objek tersebut. |
| LabeledByProperty | Null |
Kontrol item pohon adalah pelabelan mandiri. |
| LocalizedControlTypeProperty | “item pohon” | String yang dilokalkan sesuai dengan jenis kontrol TreeItem. |
| NameProperty | Lihat catatan. | Properti ini mengekspos teks yang ditampilkan untuk setiap kontrol item pohon. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh kontrol daftar. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol/Properti Pola | Dukungan/Nilai | Catatan |
|---|---|---|
| IInvokeProvider | Bergantung | Terapkan pola kontrol ini jika item pohon memiliki perintah terpisah yang dapat dilaksanakan. |
| IExpandCollapseProvider | Ya | Semua item pohon dapat diperluas atau diciutkan. |
| ExpandCollapseState | Node Diperluas, Node Diciutkan, atau Node Leaf | Item pohon akan menjadi node leaf ketika tidak diperluas atau diciutkan. |
| IScrollItemProvider | Bergantung | Terapkan pola kontrol ini jika kontainer pohon mendukung pola kontrol Gulir. |
| ISelectionItemProvider | Bergantung | Terapkan pola kontrol ini jika memungkinkan untuk memiliki pilihan aktif yang dipertahankan ketika pengguna kembali ke kontainer pohon. |
| SelectionContainer | Ya | Properti ini akan mengekspos kontainer yang sama untuk semua item dalam kontainer. |
| IToggleProvider | Bergantung | Terapkan pola kontrol ini jika item pohon memiliki kotak centang terkait. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol item tab. Untuk mendapatkan informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| AutomationFocusChangedEvent | Wajib | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| ItemStatusProperty peristiwa perubahan properti. | Bergantung | Tidak |
| NameProperty peristiwa perubahan properti. | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |
| ExpandCollapseStateProperty peristiwa perubahan properti. | Wajib | Tidak |
| InvokedEvent | Bergantung | Tidak |
| CurrentViewProperty peristiwa perubahan properti. | Bergantung | Tidak |
| ElementAddedToSelectionEvent | Bergantung | Tidak |
| ElementRemovedFromSelectionEvent | Bergantung | Tidak |
| ElementSelectedEvent | Bergantung | Tidak |
| ToggleStateProperty peristiwa perubahan properti. | Bergantung | Tidak |
| ValueProperty peristiwa perubahan properti. | Bergantung | Tidak |