Bagikan melalui

Dukungan UI Automation untuk Jenis Kontrol Pohon

  • Artikel

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 Pohon. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup panduan khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan pola kontrol.

Jenis kontrol Pohon digunakan untuk kontainer yang kontennya memiliki relevansi sebagai hierarki simpul, seperti halnya file dan folder ditampilkan di panel kiri Microsoft Windows Explorer. Setiap node memiliki potensi untuk berisi simpul 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 kejadian untuk jenis kontrol Pohon. Persyaratan UI Automation berlaku untuk semua kontrol struktur, 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 pohon 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
Pohon

  • DataItem (0 atau lebih)
  • TreeItem (0 atau lebih)

    • TreeItem (0 atau lebih)• …
  • ScrollBar (0, 1, 2)
 Pohon

  • DataItem (0 atau lebih)
  • TreeItem (0 atau lebih)

    • TreeItem (0 atau lebih)• …

Tampilan kontrol pohon UI Automation terdiri dari:

  • Nol hingga banyak item dalam kontainer (item dapat didasarkan pada Item Pohon, Item Data, atau jenis kontrol lainnya).

  • Nol, satu atau dua bilah gulir.

Tampilan konten pohon UI Automation terdiri dari nol atau banyak item dalam wadah (item dapat didasarkan pada Item Pohon, Item Data, atau tipe kontrol lainnya).

Properti Azure Automation Antarmuka Pengguna yang Diperlukan

Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol daftar. Untuk mendapatkan 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. Kontrol pohon memiliki titik yang dapat diklik yang akan menyebabkan pohon atau salah satu item dalam wadah pohon memiliki fokus yang ditetapkan pada mereka. Anda mendapatkan titik yang dapat diklik untuk pohon hanya jika Anda dapat mengklik di suatu tempat yang tidak menyebabkan salah satu item dipilih/mendapatkan fokus.
ControlTypeProperty Pohon Nilai ini sama untuk semua kerangka kerja UI.
IsContentElementProperty Benar Kontrol hierarki selalu disertakan dalam tampilan konten hierarki UI Automation.
IsControlElementProperty Benar Kontrol hierarki selalu disertakan dalam tampilan kontrol hierarki UI Automation.
IsKeyboardFocusableProperty Lihat catatan. Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini.
LabeledByProperty Lihat catatan. Jika kontrol pohon memiliki label yang terkait dengannya, properti ini akan mengembalikan AutomationElement untuk label tersebut. Jika tidak, properti akan mengembalikan referensi nol ( Nothing di Microsoft Visual Basic .NET).
LocalizedControlTypeProperty "pohon" String yang dilokalkan sesuai dengan jenis kontrol Daftar.
NameProperty Lihat catatan. Nilai properti nama kontrol pohon biasanya berasal dari teks yang melabeli kontrol. Jika tidak ada label teks, pengembang aplikasi harus memberikan nilai untuk properti ini.

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
ISelectionProvider Bergantung Kontrol pohon yang berisi sekumpulan item yang dapat dipilih harus menerapkan pola kontrol ini. Pola kontrol ini tidak harus diterapkan jika memilih item tidak menyampaikan informasi yang berarti kepada pengguna.
CanSelectMultiple Lihat catatan. Terapkan properti ini jika kontrol pohon mendukung banyak pilihan (kebanyakan kontrol pohon tidak mendukung banyak pilihan).
IsSelectionRequired Lihat catatan. Nilai properti ini diekspos jika kontrol mengharuskan item dipilih.
IScrollProvider Bergantung Terapkan pola kontrol ini jika konten kontainer pohon dapat digulir.

Peristiwa UI Automation yang Diperlukan

Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol hierarki. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.

Peristiwa UI Automation Dukungan Catatan
InvalidatedEvent Bergantung Tidak
BoundingRectangleProperty peristiwa perubahan properti. Wajib Tidak
IsOffscreenProperty peristiwa perubahan properti. Wajib Tidak
IsEnabledProperty peristiwa perubahan properti. Wajib Tidak
HorizontallyScrollableProperty peristiwa perubahan properti. Bergantung Tidak
HorizontalScrollPercentProperty peristiwa perubahan properti. Bergantung Tidak
HorizontalViewSizeProperty peristiwa perubahan properti. Bergantung Tidak
VerticalScrollPercentProperty peristiwa perubahan properti. Bergantung Tidak
VerticallyScrollableProperty peristiwa perubahan properti. Bergantung Tidak
VerticalViewSizeProperty peristiwa perubahan properti. Bergantung Tidak
AutomationFocusChangedEvent Wajib Tidak
StructureChangedEvent Wajib Tidak

Lihat juga