Bagikan melalui

Dukungan Automasi UI untuk Jenis Kontrol Pohon

Nota

Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas Automation UI terkelola yang ditentukan dalam namespace System.Windows.Automation. Untuk informasi terbaru tentang Automasi UI, lihat Windows Automation API: UI Automation.

Topik ini menyediakan informasi tentang dukungan UI Automation untuk tipe kontrol Pohon. Di Automasi UI, jenis kontrol adalah serangkaian kondisi yang harus dipenuhi kontrol untuk menggunakan ControlTypeProperty properti . Kondisi ini mencakup pedoman khusus untuk struktur pohon Automation UI, nilai properti Automation UI, 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 simpul memiliki potensi untuk berisi simpul lain, yang disebut simpul anak. Simpul induk, atau simpul yang berisi simpul anak, dapat ditampilkan sebagai diperluas atau diciutkan.

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Otomasi UI yang diperlukan untuk jenis kontrol Pohon. Persyaratan Automasi UI berlaku untuk semua kontrol pohon, baik Windows Presentation Foundation (WPF), Win32, atau Windows Forms.

Struktur Pohon Automasi UI yang Diperlukan

Tabel berikut ini menggambarkan tampilan kontrol dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol pohon 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
Pohon

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

    • TreeItem (0 atau lebih)• ...
  • Bilah Gulir (0, 1, 2)
 Pohon

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

    • TreeItem (0 atau lebih)• ...

Tampilan kontrol pohon Automation UI terdiri dari:

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

  • Nol, satu atau dua batang gulir.

Tampilan isi pohon Automation UI terdiri dari nol atau banyak item di wadah (item dapat didasarkan pada Item Pohon, Item Data, atau jenis kontrol lainnya).

Properti Otomasi Antarmuka Pengguna yang Dibutuhkan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol daftar. Untuk informasi selengkapnya tentang properti Automation UI, lihat Properti Automasi UI untuk Klien.

Properti Automasi Antarmuka Pengguna Nilai Catatan
AutomationIdProperty Lihat catatan. Nilai properti ini harus unik di semua kontrol dalam aplikasi.
BoundingRectangleProperty Lihat catatan. Persegi panjang terluar yang berisi seluruh kontrol.
ClickablePointProperty Lihat catatan. Kontrol pohon memiliki titik yang dapat diklik yang akan menyebabkan pohon atau satu item dalam kontainer pohon memiliki fokus yang ditetapkan padanya. 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 pohon selalu disertakan dalam tampilan konten pohon Automation UI.
IsControlElementProperty Benar Kontrol pohon selalu disertakan dalam tampilan kontrol pohon Automation UI.
IsKeyboardFocusableProperty Lihat catatan. Jika kontrol dapat menerima fokus keyboard, 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 null (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, maka pengembang aplikasi harus memberikan nilai untuk properti ini.

Pola Kontrol Automasi UI yang Diperlukan

Tabel berikut mencantumkan pola kontrol Automation UI yang harus didukung oleh kontrol daftar. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI .

Properti Pola/Pola Kontrol Dukungan/Nilai Catatan
ISelectionProvider Bergantung Kontrol pohon yang berisi sekumpulan item yang dapat dipilih harus menerapkan pola kontrol ini. Pola kontrol ini tidak harus diimplementasikan jika memilih item tidak menyampaikan informasi yang bermakna kepada pengguna.
CanSelectMultiple Lihat catatan. Terapkan properti ini jika kontrol pohon mendukung beberapa pilihan (sebagian besar kontrol pohon tidak mendukung beberapa 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 Automasi UI yang Diperlukan

Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan untuk didukung oleh semua kontrol pohon. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .

Peristiwa Automasi UI Dukungan Catatan
InvalidatedEvent Bergantung Tidak ada
BoundingRectangleProperty acara perubahan properti. Diperlukan Tidak ada
IsOffscreenProperty acara perubahan properti. Diperlukan Tidak ada
IsEnabledProperty acara perubahan properti. Diperlukan Tidak ada
HorizontallyScrollableProperty acara perubahan properti. Bergantung Tidak ada
HorizontalScrollPercentProperty acara perubahan properti. Bergantung Tidak ada
HorizontalViewSizeProperty acara perubahan properti. Bergantung Tidak ada
VerticalScrollPercentProperty acara perubahan properti. Bergantung Tidak ada
VerticallyScrollableProperty acara perubahan properti. Bergantung Tidak ada
VerticalViewSizeProperty acara perubahan properti. Bergantung Tidak ada
AutomationFocusChangedEvent Diperlukan Tidak ada
StructureChangedEvent Diperlukan Tidak ada

Lihat juga

  • Last updated on