Edit Tipe Kontrol
Topik ini menyediakan informasi tentang dukungan Microsoft UI Automation untuk jenis kontrol Edit .
Kontrol edit mengaktifkan pengguna untuk melihat dan mengedit baris teks sederhana tanpa dukungan pemformatan yang kaya.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol edit. Persyaratan Otomatisasi UI berlaku untuk semua kontrol pengeditan di mana kerangka kerja/platform UI mengintegrasikan dukungan Automation UI untuk jenis kontrol dan pola kontrol.
Topik ini berisi bagian berikut.
- Struktur Pohon Umum
- Properti yang Relevan
- Pola Kontrol yang Diperlukan
- Peristiwa yang Diperlukan
- Keterangan
- Topik terkait
Struktur Pohon Umum
Tabel berikut ini menggambarkan kontrol umum dan tampilan konten pohon Automation UI yang berkaitan dengan kontrol pengeditan dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Ringkasan Pohon UI Automation.
Tampilan Kontrol | Tampilan Konten |
---|---|
|
|
Kontrol yang mengimplementasikan jenis kontrol Edit akan selalu memiliki bilah gulir nol dalam tampilan kontrol pohon Automation UI karena merupakan kontrol satu baris. Baris teks tunggal dapat dibungkus dalam beberapa skenario tata letak. Jenis kontrol Edit hanya dimaksudkan untuk sejumlah kecil teks.
Properti yang Relevan
Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol pengeditan. Untuk informasi selengkapnya tentang properti Automation UI, lihat Mengambil Properti dari Elemen Automation UI.
Properti UI Automation | Nilai | Catatan |
---|---|---|
UIA_AutomationIdPropertyId | Lihat catatan. | Nilai properti ini harus unik di antara semua elemen serekan dalam tampilan mentah pohon Automation UI. |
UIA_BoundingRectanglePropertyId | Lihat catatan. | Persegi panjang terluar yang berisi seluruh kontrol. |
UIA_ClickablePointPropertyId | Lihat catatan. | Kontrol pengeditan harus memiliki titik yang dapat diklik yang memberikan fokus input ke bagian pengeditan kontrol ketika pengguna mengeklik mouse di sana. |
UIA_ControlTypePropertyId | Edit | |
UIA_IsContentElementPropertyId | TRUE | Kontrol edit selalu disertakan dalam tampilan konten pohon Automasi Antarmuka Pengguna. |
UIA_IsControlElementPropertyId | TRUE | Kontrol edit selalu disertakan dalam tampilan kontrol pohon Automasi Antarmuka Pengguna. |
UIA_IsKeyboardFocusablePropertyId | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
UIA_IsPasswordPropertyId | Lihat catatan. | Harus diatur ke TRUE pada kontrol edit yang berisi 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. |
UIA_LabeledByPropertyId | Lihat catatan. | Jika ada label teks statis yang terkait dengan kontrol, properti ini harus mengekspos referensi ke kontrol tersebut. Jika kontrol teks adalah subkomponen kontrol lain, kontrol teks tidak akan memiliki kumpulan properti LabeledBy . |
UIA_LocalizedControlTypePropertyId | Lihat catatan. | String yang dilokalkan sesuai dengan jenis kontrol Edit . Nilai defaultnya adalah "edit" untuk en-US atau English (Amerika Serikat). |
UIA_NamePropertyId | Lihat catatan. | Nama kontrol edit biasanya dihasilkan dari label teks statis. Jika tidak ada label teks statis, nilai properti untuk Nama harus ditetapkan oleh pengembang aplikasi. Properti Nama tidak boleh berisi konten tekstual kontrol edit. |
Pola Kontrol yang Diperlukan
Tabel berikut mencantumkan pola kontrol Automation UI yang diperlukan untuk didukung oleh kontrol edit. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.
Pola Kontrol/Properti Pola | Dukungan/Nilai | Catatan |
---|---|---|
IRangeValueProvider | Bergantung | Semua kontrol edit yang mengambil rentang numerik harus mengekspos pola kontrol RangeValue . |
Minimum | Lihat catatan. | Properti ini harus menjadi nilai terkecil yang isi kontrol editnya dapat diatur. |
Maksimum | Lihat catatan. | Properti ini harus menjadi nilai terbesar yang isi kontrol editnya dapat diatur. |
SmallChange | Lihat catatan. | Properti ini harus menunjukkan jumlah tempat desimal yang dapat diatur nilainya. Jika kontrol edit hanya mengambil bilangan bulat, nilai properti SmallChange harus 1. Jika kontrol edit mengambil rentang dari 1.0 hingga 2.0, maka nilai properti SmallChange harus 0,1. Jika kontrol edit mengambil rentang dari 1,00 hingga 2,00, maka nilai properti SmallChange harus 0,001. |
LargeChange | NULL | Properti ini tidak perlu diekspos pada kontrol pengeditan. |
Nilai | Lihat catatan. | Properti ini menunjukkan konten numerik kontrol edit. Ketika nilai yang lebih tepat diatur oleh klien Automation UI dalam rentang yang ditentukan dalam properti Minimum dan Maksimum , properti Nilai secara otomatis dibulatkan ke nilai terdekat yang diterima. |
ITextProvider | Diperlukan | Semua kontrol edit harus mendukung pola kontrol Teks karena informasi terperinci harus selalu tersedia untuk klien teknologi bantuan. |
IValueProvider | Bergantung | Semua kontrol edit yang mengambil string harus mengekspos pola kontrol Nilai . |
IsReadOnly | Lihat catatan. | Properti ini harus diatur untuk menunjukkan apakah kontrol dapat memiliki nilai yang ditetapkan secara terprogram, atau yang dapat diedit oleh pengguna. |
Nilai | Lihat catatan. | Properti ini berisi isi tekstual kontrol edit. Jika properti UIA_IsPasswordPropertyId diatur ke TRUE, mengkueri properti Nilai harus mengembalikan kesalahan. |
Peristiwa yang Diperlukan
Tabel berikut ini mencantumkan peristiwa Automation UI yang diperlukan kontrol pengeditan untuk didukung. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
Peristiwa UI Automation | Catatan |
---|---|
UIA_AutomationFocusChangedEventId | |
UIA_BoundingRectanglePropertyId peristiwa yang diubah properti. | |
UIA_IsEnabledPropertyId peristiwa yang diubah properti. | Jika kontrol mendukung properti IsEnabled , kontrol harus mendukung kejadian ini. |
UIA_IsOffscreenPropertyId peristiwa yang diubah properti. | Jika kontrol mendukung properti IsOffscreen , kontrol harus mendukung kejadian ini. |
UIA_NamePropertyId peristiwa yang diubah properti. | |
UIA_RangeValueValuePropertyId peristiwa yang diubah properti. | Jika kontrol mendukung pola kontrol RangeValue , kontrol harus mendukung kejadian ini. |
UIA_ScrollHorizontallyScrollablePropertyId peristiwa yang diubah properti. | Kontrol edit tidak pernah mendukung pola kontrol Gulir . |
UIA_ScrollHorizontalScrollPercentPropertyId peristiwa yang diubah properti. | Kontrol edit tidak pernah mendukung pola kontrol Gulir . |
UIA_ScrollHorizontalViewSizePropertyId peristiwa yang diubah properti. | Kontrol edit tidak pernah mendukung pola kontrol Gulir . |
UIA_ScrollVerticallyScrollablePropertyId peristiwa yang diubah properti. | Kontrol edit tidak pernah mendukung pola kontrol Gulir . |
UIA_ScrollVerticalScrollPercentPropertyId peristiwa yang diubah properti. | Kontrol edit tidak pernah mendukung pola kontrol Gulir . |
UIA_ScrollVerticalViewSizePropertyId peristiwa yang diubah properti. | Kontrol edit tidak pernah mendukung pola kontrol Gulir . |
UIA_StructureChangedEventId | |
UIA_Text_TextChangedEventId | Jika kontrol mendukung pola kontrol Teks , kontrol teks harus mendukung kejadian ini. |
UIA_Text_TextSelectionChangedEventId | Jika kontrol mendukung pola kontrol Teks , kontrol teks harus mendukung kejadian ini. |
UIA_ValueValuePropertyId peristiwa yang diubah properti . | Jika kontrol mendukung pola kontrol Nilai , kontrol harus mendukung peristiwa ini. |
Keterangan
Kontrol edit dapat digunakan sebagai bidang teks baca-saja yang tidak mendukung pilihan atau pengeditan teks. Kontrol edit semacam itu bertingkah seperti objek bidang yang memiliki nama dan nilai tertentu.
Jika kontrol edit berisi teks tempat penampung (misalnya, banner iseng), teks harus digunakan sebagai properti HelpText kecuali teks dapat diedit oleh pengguna lalu digunakan kembali sebagai teks tempat penampung. Misalnya, bilah alamat Windows Internet Explorer berisi teks "about:Tabs" saat tab baru dibuka. Ini bukan HelpText karena ini adalah alamat terprogram yang dapat digunakan atau diedit oleh pengguna.
Topik terkait