Bagikan melalui


Dukungan Automasi UI untuk Jenis Kontrol Bilah Alat

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 ToolBar. 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. Kontrol bilah alat memungkinkan pengguna akhir mengaktifkan perintah dan alat yang terkandung dalam aplikasi.

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol ToolBar. Persyaratan Otomatisasi UI berlaku untuk semua kontrol bilah alat, baik Windows Presentation Foundation (WPF), Win32, atau Windows Forms.

Struktur Pohon Automasi UI yang Diperlukan

Tabel berikut menggambarkan tampilan kontrol dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol bilah alat 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
Bilah Alat

- Berbagai kontrol (0 atau lebih)
Bilah Alat

- Berbagai kontrol (0 atau lebih)

Kontrol bilah alat dapat berisi semua jenis kontrol dalam subtreenya. Mereka paling sering berisi tombol, kotak kombo, dan tombol terpisah.

Properti Otomasi Antarmuka Pengguna yang Dibutuhkan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol bilah alat. 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. Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam persegi panjang pembatas dapat diklik, dan Anda melakukan pengujian hit khusus, maka ambil alih dan berikan titik yang dapat diklik.
IsKeyboardFocusableProperty Lihat catatan. Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini.
NameProperty Bergantung Kontrol bilah alat tidak memerlukan nama kecuali lebih dari satu digunakan dalam aplikasi. Jika ada lebih dari satu, masing-masing harus memiliki nama pembeda (misalnya, Pemformatan atau Penggambaran).
LabeledByProperty Null Kontrol bilah alat tidak pernah memiliki label.
ControlTypeProperty Bilah Alat Nilai ini sama untuk semua kerangka kerja UI.
LocalizedControlTypeProperty "bilah alat" Teks yang sudah dilokalkan untuk jenis kontrol ToolBar.
IsContentElementProperty Benar Kontrol bilah alat selalu konten.
IsControlElementProperty Benar Kontrol bilah alat harus selalu berfungsi sebagai kontrol.

Pola Kontrol Automasi UI yang Diperlukan

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

Pola Kontrol Dukungan Catatan
ExpandCollapsePattern Bergantung Jika bilah alat dapat diperluas dan diciutkan untuk menampilkan lebih banyak item, maka harus mendukung pola ini.
DockPattern Bergantung Jika bilah alat dapat dijangkar ke berbagai bagian layar, maka harus mendukung pola ini.
TransformPattern Bergantung Jika bilah alat dapat diubah ukurannya, diputar, atau dipindahkan, bilah alat harus mendukung pola ini.

Peristiwa Automasi UI yang Diperlukan

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

Peristiwa Automasi UI Dukungan Catatan
BoundingRectangleProperty acara perubahan properti. Diperlukan Tidak ada
IsOffscreenProperty acara perubahan properti. Diperlukan Tidak ada
IsEnabledProperty acara perubahan properti. Diperlukan Tidak ada
ExpandCollapseStateProperty acara perubahan properti. Bergantung Tidak ada
AutomationFocusChangedEvent Diperlukan Tidak ada
StructureChangedEvent Diperlukan Tidak ada

Lihat juga