Bagikan melalui

Dukungan Automasi UI untuk Jenis Kontrol Tombol

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

Tombol adalah objek yang berinteraksi dengan pengguna untuk melakukan tindakan seperti tombol OK dan Batal pada kotak dialog. Kontrol tombol adalah kontrol sederhana untuk diekspos karena memetakan ke satu perintah yang ingin diselesaikan pengguna.

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol Tombol. Persyaratan Automasi UI berlaku untuk semua kontrol tombol, 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 tombol 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
Tombol

- Gambar (0 atau lebih)
- Teks (0 atau lebih)		 Tombol

Properti Otomasi Antarmuka Pengguna yang Dibutuhkan

Tabel berikut mencantumkan properti UI Otomasi yang nilai atau definisinya sangat relevan untuk kontrol yang menggunakan tipe kontrol Tombol (seperti kontrol tombol). Untuk informasi selengkapnya tentang properti Automation UI, lihat Properti Automasi UI untuk Klien.

Properti Automasi Antarmuka Pengguna Nilai Catatan
AcceleratorKeyProperty Lihat catatan. Kontrol Tombol biasanya harus mendukung kunci akselerator untuk memungkinkan pengguna akhir melakukan tindakan yang diwakilinya dengan cepat dari keyboard.
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.
ControlTypeProperty Tombol Nilai ini sama untuk semua kerangka kerja UI.
HelpTextProperty Lihat catatan. Teks Bantuan dapat menunjukkan hasil akhir mengaktifkan tombol. Ini biasanya merupakan jenis informasi yang sama yang disajikan melalui ToolTip.
IsContentElementProperty Benar Kontrol Tombol harus selalu berisi.
IsControlElementProperty Benar Tombol harus selalu menjadi kontrol.
IsKeyboardFocusableProperty Lihat catatan. Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini.
LabeledByProperty Null Kontrol tombol diberi label sendiri oleh kontennya.
LocalizedControlTypeProperty "tombol" String yang dilokalkan sesuai dengan jenis kontrol Tombol.
NameProperty Lihat catatan. Nama kontrol tombol adalah teks yang digunakan untuk memberi label. Setiap kali gambar digunakan untuk memberi label tombol, teks alternatif harus disediakan untuk properti Nama tombol.

Pola Kontrol Automasi UI yang Diperlukan

Tabel berikut mencantumkan pola kontrol Automation UI yang diperlukan untuk didukung oleh semua kontrol tombol. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI .

Pola Kontrol Dukungan Catatan
IInvokeProvider Lihat catatan. Semua tombol harus mendukung pola kontrol invokasi atau pola kontrol pengalih. Panggil didukung ketika tombol melakukan perintah atas permintaan pengguna. Perintah ini memetakan ke satu operasi seperti Potong, Salin, Tempel, atau Hapus.
IToggleProvider Lihat catatan. Semua tombol harus mendukung pola kontrol invokasi atau pola kontrol pengalih. Pengalihan didukung jika tombol dapat diganti melalui serangkaian hingga tiga keadaan. Biasanya ini terlihat sebagai sakelar on/off untuk fitur tertentu.
IExpandCollapseProvider Lihat catatan. Ketika tombol ditempatkan sebagai anak dari tombol gabungan, tombol anak dapat mendukung Pola ExpandCollapse dibandingkan dengan Pola Panggil atau Pola Alihkan. Pola ExpandCollapse dapat digunakan untuk membuka atau menutup menu atau substruktur lain yang terkait dengan elemen tombol.

Peristiwa Automasi UI yang Diperlukan

Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan untuk didukung oleh semua kontrol tombol. 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
IsOffscreenProperty acara perubahan properti. Diperlukan Tidak ada
IsEnabledProperty acara perubahan properti. Diperlukan Tidak ada
NameProperty acara perubahan properti. Diperlukan Tidak ada
StructureChangedEvent Diperlukan Tidak ada
InvokedEvent Bergantung Jika kontrol mendukung pola kontrol Pemanggilan, maka kontrol tersebut harus mendukung kejadian ini.
ToggleStateProperty acara perubahan properti. Bergantung Jika kontrol mendukung pola kontrol Toggle, kontrol harus mendukung kejadian ini.

Lihat juga

  • Last updated on