Dukungan UI Automation untuk Jenis Kontrol Pengeditan
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 memberikan informasi tentang dukungan UI Automation untuk jenis kontrol Pengeditan. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup panduan khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan pola kontrol.
Kontrol edit mengaktifkan pengguna untuk melihat dan mengedit baris teks sederhana tanpa dukungan pemformatan yang kaya.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan peristiwa untuk jenis kontrol Pengeditan. Persyaratan UI Automation berlaku untuk semua kontrol pengeditan, baik Windows Presentation Foundation (WPF), Win32, maupun Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten dari pohon UI Automation yang berkaitan dengan kontrol pengeditan dan menjelaskan yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Ringkasan Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Edit | Edit |
Kontrol yang menerapkan jenis kontrol Pengeditan akan selalu memiliki bilah gulir nol dalam tampilan kontrol pohon UI Automation karena merupakan kontrol satu baris. Baris teks tunggal dapat dibungkus dalam beberapa skenario tata letak. Jenis kontrol Pengeditan paling cocok untuk menyimpan sejumlah kecil teks yang dapat diedit atau dapat dipilih.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol pengeditan. Untuk mendapatkan 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. |
| ClickablePointProperty | Lihat catatan. | Kontrol pengeditan harus memiliki titik yang dapat diklik yang memberikan fokus input ke bagian pengeditan kontrol ketika pengguna mengeklik mouse di sana. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Lihat catatan. | Nama kontrol edit biasanya dihasilkan dari label teks statis. Jika tidak ada label teks statik, nilai properti untuk Name harus ditetapkan oleh pengembang aplikasi. Properti Name tidak boleh memuat konten tekstual kontrol pengeditan. |
| LabeledByProperty | Lihat catatan. | Jika ada label teks statis yang terkait dengan kontrol, maka properti ini harus mengekspos referensi ke kontrol tersebut. Jika kontrol teks adalah subkomponen dari kontrol lain, kontrol teks tidak akan memiliki kumpulan properti LabeledBy. |
| ControlTypeProperty | Edit | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | “pengeditan” | String yang dilokalkan sesuai dengan jenis kontrol Pengeditan. |
| IsContentElementProperty | Benar | Kontrol edit selalu disertakan dalam tampilan konten pohon Automasi Antarmuka Pengguna. |
| IsControlElementProperty | Benar | Kontrol pengeditan selalu disertakan dalam tampilan kontrol pohon UI Automation. |
| IsPasswordProperty | Lihat catatan. | Harus diatur ke true pada kontrol pengeditan yang memuat kata sandi. Jika kontrol pengeditan memuat konten Kata Sandi, maka properti ini dapat digunakan oleh pembaca layar untuk menentukan apakah penekanan tombol harus dibaca ketika pengguna mengetiknya. |
Pola dan Properti Kontrol UI Automation yang Diperlukan
Tabel berikut mencantumkan pola kontrol yang diperlukan untuk didukung oleh semua kontrol pengeditan. Untuk mendapatkan informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.
| Properti Pola Kontrol/Pola Kontrol | Dukungan/Nilai | Catatan |
|---|---|---|
| ITextProvider | Bergantung | Kontrol pengeditan harus mendukung pola kontrol Teks karena informasi teks terperinci harus selalu tersedia untuk klien. |
| IValueProvider | Bergantung | Semua kontrol pengeditan yang mengambil string harus mengekspos pola Nilai. |
| IsReadOnly | Lihat catatan. | Properti ini harus diatur untuk menunjukkan apakah kontrol dapat memiliki nilai yang ditetapkan secara terprogram atau dapat diedit oleh pengguna. |
| Value | Lihat catatan. | Properti ini akan mengembalikan konten tekstual kontrol pengeditan. Jika IsPasswordProperty diatur ke true, properti ini harus menaikkan InvalidOperationException ketika diminta. |
| IRangeValueProvider | Bergantung | Semua kontrol pengeditan yang mengambil rentang numerik harus mengekspos pola kontrol Nilai Rentang. |
| Minimum | Lihat catatan. | Properti ini harus menjadi nilai terkecil tempat konten kontrol pengeditan dapat diatur. |
| Maximum | Lihat catatan. | Properti ini harus menjadi nilai terbesar tempat konten kontrol pengeditan dapat diatur. |
| SmallChange | Lihat catatan. | Properti ini harus menunjukkan jumlah tempat desimal yang dapat diatur nilainya. Jika pengeditan hanya mengambil bilangan bulat, SmallChangeProperty harus menjadi 1. Jika pengeditan mengambil rentang dari 1.0 hingga 2.0, maka SmallChangeProperty harus menjadi 0,1. Jika kontrol pengeditan mengambil rentang dari 1.00 hingga 2.00, maka SmallChangeProperty harus menjadi 0,001. |
| LargeChange | Null |
Properti ini tidak perlu diekspos pada kontrol pengeditan. |
| Value | Lihat catatan. | Properti ini akan menunjukkan konten numerik dari kontrol pengeditan. Ketika nilai yang lebih tepat ditetapkan oleh klien UI Automation dalam rentang yang ditentukan dalam properti Minimum dan Maximum, properti Nilai akan secara otomatis dibulatkan ke nilai terdekat yang diterima. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol pengeditan. Untuk mendapatkan informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| InvalidatedEvent | Wajib | Tidak |
| TextSelectionChangedEvent | Wajib | Tidak |
| TextChangedEvent | 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 |
| ValueProperty peristiwa perubahan properti. | Bergantung | Tidak |
| HorizontallyScrollableProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| HorizontalScrollPercentProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| HorizontalViewSizeProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| VerticalScrollPercentProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| VerticallyScrollableProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| VerticalViewSizeProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| ValueProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola kontrol Nilai rentang, kontrol harus mendukung peristiwa ini. |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |