Bagikan melalui

Dukungan Automasi UI untuk Tipe Kontrol Edit

Nota

Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas Automation UI terkelola yang ditentukan dalam namespace System.Windows.Automation. Untuk informasi terbaru tentang Automasi UI, lihat Windows Automation API: UI Automation.

Topik ini menyediakan informasi tentang dukungan Automation UI untuk jenis kontrol Edit. Di Automasi UI, jenis kontrol adalah serangkaian kondisi yang harus dipenuhi kontrol untuk menggunakan ControlTypeProperty properti . Kondisi ini mencakup pedoman khusus untuk struktur pohon Automation UI, nilai properti Automation UI, dan pola kontrol.

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 Otomatisasi UI berlaku untuk semua kontrol pengeditan, baik Windows Presentation Foundation (WPF), Win32, atau Windows Forms.

Struktur Pohon Automasi UI yang Diperlukan

Tabel berikut ini menggambarkan tampilan kontrol 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 satu baris. Baris tunggal teks dapat dibungkus dalam beberapa skenario tata letak. Jenis kontrol Edit paling cocok untuk menyimpan sejumlah kecil teks yang dapat diedit atau dapat dipilih.

Properti Otomasi Antarmuka Pengguna yang Dibutuhkan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan untuk kontrol pengeditan. Untuk informasi selengkapnya tentang properti Automation UI, lihat Properti Automasi UI untuk Klien.

Properti Automasi Antarmuka Pengguna Nilai Catatan
AutomationIdProperty Lihat catatan. Nilai properti ini harus unik di semua kontrol dalam aplikasi.
BoundingRectangleProperty Lihat catatan. Persegi panjang terluar yang berisi seluruh kontrol.
ClickablePointProperty Lihat catatan. Kontrol edit harus memiliki titik yang dapat diklik yang memberikan fokus input ke bagian edit kontrol ketika pengguna mengklik mouse di sana.
IsKeyboardFocusableProperty Lihat catatan. Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini.
NameProperty Lihat catatan. Nama kontrol edit biasanya dihasilkan dari label teks statis. Jika tidak ada label teks statis, nilai properti untuk Name harus ditetapkan oleh pengembang aplikasi. Properti Name seharusnya tidak pernah berisi isi teks dari 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 kontrol lain, kontrol teks tidak akan memiliki kumpulan LabeledBy properti.
ControlTypeProperty Mengedit Nilai ini sama untuk semua kerangka kerja UI.
LocalizedControlTypeProperty "edit" String yang dilokalkan sesuai dengan jenis kontrol Edit.
IsContentElementProperty Benar Kontrol edit selalu disertakan dalam tampilan konten pohon Automation UI.
IsControlElementProperty Benar Kontrol edit selalu disertakan dalam tampilan kontrol pohon Automation UI.
IsPasswordProperty 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.

Pola dan Properti Kontrol Automasi UI yang Diperlukan

Tabel berikut mencantumkan pola kontrol yang diperlukan untuk didukung oleh semua kontrol edit. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI.

Properti Pola Kontrol/Properti Pola Kontrol Dukungan/Nilai Catatan
ITextProvider Bergantung Kontrol edit harus mendukung pola kontrol Teks karena informasi teks terperinci harus selalu tersedia untuk klien.
IValueProvider Bergantung Semua kontrol edit 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 dari kontrol pengeditan. Jika IsPasswordProperty diatur ke true, properti ini harus menaikkan InvalidOperationException saat diminta.
IRangeValueProvider Bergantung Semua kontrol edit yang mengambil rentang numerik harus mengekspos pola kontrol Nilai Rentang.
Minimum Lihat catatan. Properti ini harus menjadi nilai terkecil yang dapat diatur untuk isi dari komponen kontrol edit.
Maximum Lihat catatan. Properti ini harus menjadi nilai terbesar yang dapat ditetapkan pada isi kontrol edit.
SmallChange Lihat catatan. Properti ini harus menunjukkan jumlah tempat desimal yang dapat diatur nilainya. Jika pengeditan hanya mengambil bilangan bulat, SmallChangeProperty harus 1. Jika pengeditan mengambil rentang dari 1.0 hingga 2.0, maka SmallChangeProperty harus 0,1. Jika kontrol edit mengambil rentang dari 1,00 hingga 2,00 maka SmallChangeProperty harus 0,001.
LargeChange Null Properti ini tidak perlu diekspos pada kontrol edit.
Value Lihat catatan. Properti ini akan menunjukkan isi numerik kontrol edit. Ketika nilai yang lebih tepat diatur oleh klien UI Automation dalam rentang yang ditentukan oleh properti Minimum dan Maximum, properti Nilai akan dibulatkan secara otomatis ke nilai terdekat yang diperbolehkan.

Peristiwa Automasi UI yang Diperlukan

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

Peristiwa Automasi UI Dukungan Catatan
InvalidatedEvent Diperlukan Tidak ada
TextSelectionChangedEvent Diperlukan Tidak ada
TextChangedEvent Diperlukan Tidak ada
BoundingRectangleProperty acara perubahan properti. Diperlukan Tidak ada
IsOffscreenProperty acara perubahan properti. Diperlukan Tidak ada
IsEnabledProperty acara perubahan properti. Diperlukan Tidak ada
NameProperty acara perubahan properti. Diperlukan Tidak ada
ValueProperty acara perubahan properti. Bergantung Tidak ada
HorizontallyScrollableProperty acara perubahan properti. Tidak pernah Tidak ada
HorizontalScrollPercentProperty acara perubahan properti. Tidak pernah Tidak ada
HorizontalViewSizeProperty acara perubahan properti. Tidak pernah Tidak ada
VerticalScrollPercentProperty acara perubahan properti. Tidak pernah Tidak ada
VerticallyScrollableProperty acara perubahan properti. Tidak pernah Tidak ada
VerticalViewSizeProperty acara perubahan properti. Tidak pernah Tidak ada
ValueProperty acara perubahan properti. Bergantung Jika kontrol mendukung pola kontrol Nilai rentang, kontrol tersebut harus mendukung peristiwa ini.
AutomationFocusChangedEvent Diperlukan Tidak ada
StructureChangedEvent Diperlukan Tidak ada

Lihat juga

  • Last updated on