Bagikan melalui

Dukungan Automasi UI untuk Jenis Kontrol TreeItem

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 Automation UI untuk jenis kontrol TreeItem. Di Automasi UI, jenis kontrol adalah serangkaian kondisi yang harus dipenuhi kontrol untuk menggunakan ControlTypeProperty properti . Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan pola kontrol.

Jenis kontrol TreeItem mewakili simpul dalam kontainer pohon. Setiap simpul mungkin 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 TreeItem. Persyaratan Otomatisasi UI berlaku untuk semua kontrol item 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 item 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
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 nol atau lebih anak item pohon dalam tampilan konten pohon Automation UI. Jika item dalam kontrol pohon memiliki fungsionalitas di luar apa yang terlihat dalam pola kontrol yang tercantum di bawah ini, maka kontrol harus berdasarkan pada tipe kontrol Item Data.

Item pohon yang diciutkan tidak akan ditampilkan dalam tampilan kontrol atau tampilan konten hingga diperluas dan terlihat (atau, dapat digulir ke tampilan).

Tampilan kontrol dapat berisi detail tambahan untuk kontrol, termasuk gambar atau tombol terkait. Misalnya, item dalam tampilan kerangka mungkin berisi gambar serta tombol untuk memperluas atau menciutkan kerangka. Objek detail ini tidak muncul dalam tampilan konten karena informasi sudah diwakili oleh item pohon induk. Item pohon yang tergulir dari layar akan muncul baik di tampilan kontrol maupun konten pohon UI Otomatis dan harus diatur IsOffscreenProperty ke true.

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. Properti ini harus mengembalikan lokasi item yang 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 Automation UI.
IsControlElementProperty Benar Kontrol daftar selalu disertakan dalam tampilan kontrol pohon Automation UI.
IsOffscreenProperty Lihat catatan. Properti ini diatur untuk menunjukkan kapan kontrol item pohon digulir ke luar layar.
IsKeyboardFocusableProperty Lihat catatan. Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini.
ItemTypeProperty Lihat catatan. Jika kontrol item pohon menggunakan ikon visual untuk menunjukkan bahwa adalah jenis objek tertentu, maka properti ini harus didukung dan menunjukkan apa 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 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
IInvokeProvider Bergantung Terapkan pola kontrol ini jika item pohon memiliki perintah terpisah yang dapat ditindakkan.
IExpandCollapseProvider Ya Semua item pohon dapat diperluas atau diciutkan.
ExpandCollapseState Simpul Diperluas, Diciutkan, atau Daun Item pohon akan menjadi simpul daun 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 saat pengguna kembali ke kontainer pohon.
SelectionContainer Ya Properti ini akan memaparkan kontainer yang sama untuk semua item di dalamnya.
IToggleProvider Bergantung Terapkan pola kontrol ini jika item pohon memiliki kotak centang terkait.

Peristiwa Automasi UI yang Diperlukan

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

Peristiwa Automasi UI Dukungan Catatan
AutomationFocusChangedEvent Diperlukan Tidak ada
BoundingRectangleProperty acara perubahan properti. Diperlukan Tidak ada
IsEnabledProperty acara perubahan properti. Diperlukan Tidak ada
IsOffscreenProperty acara perubahan properti. Diperlukan Tidak ada
ItemStatusProperty acara perubahan properti. Bergantung Tidak ada
NameProperty acara perubahan properti. Diperlukan Tidak ada
StructureChangedEvent Diperlukan Tidak ada
ExpandCollapseStateProperty acara perubahan properti. Diperlukan Tidak ada
InvokedEvent Bergantung Tidak ada
CurrentViewProperty acara perubahan properti. Bergantung Tidak ada
ElementAddedToSelectionEvent Bergantung Tidak ada
ElementRemovedFromSelectionEvent Bergantung Tidak ada
ElementSelectedEvent Bergantung Tidak ada
ToggleStateProperty acara perubahan properti. Bergantung Tidak ada
ValueProperty acara perubahan properti. Bergantung Tidak ada

Lihat juga

  • Last updated on