Dukungan UI Automation untuk Jenis Kontrol Tombol
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 menyediakan informasi tentang dukungan UI Automation untuk jenis kontrol Tombol. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Ketentuan tersebut mencakup panduan khusus untuk struktur pohon UI Automation, nilai properti UI Automation, pola kontrol, dan peristiwa UI Automation.
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 UI Automation yang diperlukan untuk jenis kontrol Tombol. Persyaratan UI Automation berlaku untuk semua kontrol tombol, baik Windows Presentation Foundation (WPF), Win32, maupun Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten pohon UI Automation yang berkaitan dengan kontrol tombol dan menjelaskan yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Ringkasan Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Tombol - Image (0 atau lebih) - Teks (0 atau lebih) |
Tombol |
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol yang menerapkan jenis kontrol Tombol (seperti kontrol tombol). Untuk mendapatkan informasi selengkapnya tentang properti UI Automation, lihat Properti UI Automation untuk Klien.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| AcceleratorKeyProperty | Lihat catatan. | Kontrol Tombol biasanya harus mendukung kunci akselerator untuk mengaktifkan 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 terluar yang berisi seluruh kontrol. |
| ClickablePointProperty | Lihat catatan. | Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam kotak 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 dari mengaktifkan tombol. Teks ini biasanya merupakan jenis informasi yang sama yang disajikan melalui ToolTip. |
| IsContentElementProperty | Benar | Kontrol Tombol harus selalu berupa konten. |
| IsControlElementProperty | Benar | Kontrol Tombol harus selalu berupa kontrol. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka 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 Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh semua kontrol tombol. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IInvokeProvider | Lihat catatan. | Semua tombol harus mendukung pola kontrol Pemanggilan atau pola kontrol Alihkan. 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 Pemanggilan atau pola kontrol Alihkan. Alihkan didukung jika tombol dapat diputar melalui serangkaian hingga tiga status. Biasanya ini dilihat sebagai sakelar nyala/mati untuk fitur tertentu. |
| IExpandCollapseProvider | Lihat catatan. | Ketika tombol dihosting sebagai elemen turunan dari tombol pemisah, tombol elemen turunan dapat mendukung pola ExpandCollapse alih-alih pola Panggil atau Alihkan. Pola ExpandCollapse dapat digunakan untuk membuka atau menutup menu atau sub-struktur lain yang terkait dengan elemen tombol. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol tombol. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| AutomationFocusChangedEvent | Wajib | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| NameProperty peristiwa perubahan properti. | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |
| InvokedEvent | Bergantung | Jika kontrol mendukung pola kontrol Panggil, kontrol harus mendukung peristiwa ini. |
| ToggleStateProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola kontrol Panggil, kontrol harus mendukung peristiwa ini. |