Dukungan UI Automation untuk Jenis Kontrol RadioButton
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 RadioButton. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti dan pola kontrol UI Automation.
Tombol radio terdiri atas tombol bulat dan teks yang ditentukan aplikasi (label), ikon, atau bitmap yang menunjukkan pilihan yang dapat dibuat pengguna dengan memilih tombol. Aplikasi biasanya menggunakan tombol radio dalam kotak grup untuk mengizinkan pengguna memilih dari sekumpulan opsi terkait, tetapi saling eksklusif. Contohnya, aplikasi dapat menyajikan grup tombol radio tempat pengguna dapat memilih preferensi format untuk teks yang dipilih di area klien. Pengguna dapat memilih format rata kiri, rata kanan, atau tengah dengan memilih tombol radio yang sesuai. Biasanya, pengguna hanya dapat memilih satu opsi pada satu waktu dari sekumpulan tombol radio.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa UI Automation yang diperlukan untuk jenis kontrol RadioButton. Persyaratan UI Automation berlaku untuk semua kontrol daftar, baik Windows Presentation Foundation (WPF), Win32, atau Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten pohon UI Automation yang berkaitan dengan kontrol tombol radio dan menjelaskan yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| RadioButton | RadioButton |
Tidak ada elemen turunan dalam tampilan kontrol atau tampilan konten.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan jenis kontrol RadioButton. Untuk informasi selengkapnya tentang properti UI Automation, lihat Properti UI Automation untuk Klien.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| AutomationIdProperty | Lihat catatan. | Nilai properti ini harus unik di semua kontrol dalam aplikasi. |
| BoundingRectangleProperty | Lihat catatan. | Persegi terluar yang berisi seluruh kontrol. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Lihat catatan. | Nama kontrol tombol radio adalah teks yang ditampilkan di samping tombol yang mempertahankan status pilihan. |
| ClickablePointProperty | Lihat catatan. | Titik yang dapat diklik kontrol tombol radio HARUS berupa titik yang mengatur pilihan pada tombol radio jika diklik dengan pointer mouse. |
| LabeledByProperty | Null |
Tombol radio adalah kontrol pelabelan mandiri. |
| ControlTypeProperty | RadioButton | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | “tombol radio” | String yang dilokalkan sesuai dengan Jenis kontrol RadioButton. |
| IsContentElementProperty | Benar | Kontrol tombol radio selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsControlElementProperty | Benar | Kontrol tombol radio selalu disertakan dalam tampilan kontrol pohon UI Automation. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh semua kontrol tombol radio. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Properti Pola Kontrol/Pola Kontrol | Dukungan/Nilai | Catatan |
|---|---|---|
| ISelectionItemProvider | Ya | Semua kontrol tombol radio harus mendukung pola Item Pilihan untuk mengaktifkan diri mereka sendiri agar dipilih. |
| SelectionContainer | Lihat catatan. | SelectionContainerProperty harus selalu diselesaikan sehingga klien UI Automation dapat menentukan tombol radio lain dalam konteks tertentu yang terkait satu sama lain. Untuk tombol radio versi Win32, properti ini tidak akan didukung karena tidak dimungkinkan untuk mendapatkan informasi ini dari kerangka kerja lama tersebut. |
| IToggleProvider | Tidak pernah | Tombol radio tidak dapat berputar melalui statusnya setelah diatur. Pola ini tidak boleh didukung pada tombol radio. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol tombol radio. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| ElementRemovedFromSelectionEvent | Wajib | Tidak |
| ElementSelectedEvent | Wajib | Tidak |
| ToggleStateProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |