Bagikan melalui

Edit Tipe Kontrol

  • Artikel

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

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
  • Edit
  • Edit

 

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.

Konseptual

Gambaran Umum Jenis Kontrol UI Automation

Gambaran Umum UI Automation