Bagikan melalui

Edit Tipe Kontrol

  • Artikel

Topik ini menyediakan informasi tentang dukungan Microsoft UI Automation untuk jenis kontrol Edit.

Edit kontrol memungkinkan 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 Automasi UI berlaku untuk semua kontrol edit tempat 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 Automation UI, lihat Gambaran Umum Pohon Automasi UI .

Tampilan Kontrol Tampilan Isi
  • Mengedit
  • Mengedit

 

Kontrol yang mengimplementasikan jenis kontrol Edit akan selalu memiliki bilah gulir nol dalam tampilan kontrol pohon Automation UI karena merupakan kontrol garis tunggal. Baris tunggal teks dapat dibungkus dalam beberapa skenario tata letak. Jenis kontrol Edit hanya dimaksudkan untuk teks dalam jumlah kecil.

Properti yang Relevan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol edit. Untuk informasi selengkapnya tentang properti Automation UI, lihat Mengambil Properti dari Elemen Automation UI.

Properti Automasi UI 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 edit harus memiliki titik yang dapat diklik yang memberikan fokus input ke bagian edit kontrol ketika pengguna mengklik mouse di sana.
UIA_ControlTypePropertyId Edit
UIA_IsContentElementPropertyId TRUE Kontrol edit selalu disertakan dalam tampilan konten pohon Automation UI.
UIA_IsControlElementPropertyId TRUE Kontrol edit selalu disertakan dalam tampilan kontrol pohon Automation UI.
UIA_IsKeyboardFocusablePropertyId Lihat catatan. Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini.
UIA_IsPasswordPropertyId Lihat catatan. Harus diatur ke TRUE pada kontrol edit yang berisi kata sandi. Jika kontrol edit memang berisi isi Kata Sandi, maka properti ini dapat digunakan oleh pembaca layar untuk menentukan apakah penekanan tombol harus dibaca saat 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 Inggris (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 Automasi UI .

Properti Pola/Pola Kontrol Dukungan/Nilai Catatan
IRangeValueProvider Tergantung Semua kontrol edit yang mengambil rentang numerik harus mengekspos pola kontrol RangeValue.
Minimum Lihat catatan. Properti ini harus menjadi nilai terkecil di mana isi kontrol edit dapat diatur.
Maksimum Lihat catatan. Properti ini harus menjadi nilai terbesar di mana konten kontrol edit 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 edit.
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 propertiMinimumdan Maksimum, propertiNilaisecara 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 Tergantung 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 diatur 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 propertiNilaiharus mengembalikan kesalahan.

 

Peristiwa yang Diperlukan

Tabel berikut mencantumkan peristiwa Automasi UI yang kontrol edit diperlukan untuk didukung. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .

Peristiwa Automasi UI Catatan
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId peristiwa yang diubah properti.
UIA_IsEnabledPropertyId peristiwa yang diubah properti. Jika kontrol mendukung propertiIsEnabled, kontrol harus mendukung peristiwa ini.
UIA_IsOffscreenPropertyId peristiwa yang diubah properti. Jika kontrol mendukung propertiIsOffscreen, kontrol harus mendukung peristiwa 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 harus mendukung peristiwa ini.
UIA_Text_TextSelectionChangedEventId Jika kontrol mendukung pola kontrol Teks, kontrol harus mendukung peristiwa ini.
UIA_ValueValuePropertyId peristiwa yang diubah properti . Jika kontrol mendukung pola kontrol Nilai, kontrol harus mendukung peristiwa ini.

 

Komentar

Kontrol edit dapat digunakan sebagai bidang teks baca-saja yang tidak mendukung pemilihan atau pengeditan teks. Kontrol edit semacam itu berulah sebagai objek bidang yang memiliki nama dan nilai tertentu.

Jika kontrol edit berisi teks tempat penampung (misalnya, banner iseng), teks harus digunakan sebagai properti Teks Bantuan 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 Tipe Kontrol Automasi UI

Gambaran Umum Automasi UI