Bagikan melalui

Tipe Kontrol Teks

  • Artikel

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

Kontrol teks adalah item antarmuka pengguna dasar yang mewakili sepotong teks di layar.

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol Teks. Persyaratan Automasi UI berlaku untuk semua kontrol pohon 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 teks 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
  • Teks
  • Teks (jika konten)

 

Kontrol teks dapat digunakan sendiri sebagai label atau sebagai teks statis pada formulir. Ini juga dapat dimuat dalam struktur salah satu item berikut:

Kontrol teks mungkin tidak muncul dalam tampilan konten pohon Automation UI karena teks sering ditampilkan melalui properti Nama kontrol lain. Misalnya, teks yang digunakan untuk memberi label kontrol kotak kombo diekspos melalui properti Nama kontrol. Karena kontrol kotak kombo berada dalam tampilan konten pohon Automation UI, kontrol teks tidak perlu ada. Kontrol teks mungkin memiliki turunan dalam tampilan konten jika ada objek yang disematkan seperti hyperlink.

Properti yang Relevan

Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol teks. 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. Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam persegi panjang pembatas dapat diklik, dan elemen melakukan pengujian hit khusus, ambil alih dan berikan titik yang dapat diklik.
UIA_ControlTypePropertyId Teks
UIA_IsContentElementPropertyId Tergantung Kontrol teks adalah konten jika berisi informasi yang tidak diekspos di properti Nama kontrol lain.
UIA_IsControlElementPropertyId BENAR Kontrol teks harus selalu menjadi kontrol.
UIA_IsKeyboardFocusablePropertyId Lihat catatan. Jika kontrol dapat menerima fokus keyboard, kontrol harus mendukung properti ini.
UIA_LabeledByPropertyId NOL Kontrol teks tidak memiliki label teks statis.
UIA_LocalizedControlTypePropertyId Lihat catatan. String yang dilokalkan sesuai dengan jenis kontrol Teks. Nilai defaultnya adalah "teks" untuk en-US atau Inggris (Amerika Serikat).
UIA_NamePropertyId Lihat catatan. Nama kontrol teks bisa menjadi teks yang ditampilkannya. Namun, jika kontrol juga mendukung pola Teks, dan teksnya luas, jangan gunakan konten teks lengkap sebagai nilai Nama. Sebagai gantinya, berikan nilai Nama yang lebih pendek, berasal dari properti kontrol Anda lainnya.

 

Pola Kontrol yang Diperlukan

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

Pola Kontrol Dukung Catatan
IGridItemProvider Tergantung Jika kontrol teks terkandung dalam kontrol tabel, pola kontrol GridItem harus didukung.
ITableItemProvider Tergantung Jika kontrol teks terkandung dalam kontrol tabel, pola kontrol TableItem harus didukung.
ITextProvider Tergantung Teks harus mendukung pola kontrol Teks untuk aksesibilitas yang lebih baik; namun, itu tidak diperlukan. Pola kontrol Teks berguna ketika teks memiliki gaya dan atribut yang kaya (misalnya, warna, tebal, dan miring).
IValueProvider Tidak pernah Kontrol teks tidak pernah mendukung pola kontrol Nilai. Jika teks dapat diedit, teks adalah jenis kontrol Edit.

 

Peristiwa yang Diperlukan

Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan kontrol teks 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_StructureChangedEventId
UIA_Text_TextChangedEventId Jika kontrol mendukung pola kontrol Teks, kontrol harus mendukung peristiwa ini.

 

Konseptual

Gambaran Umum Tipe Kontrol Automasi UI

Gambaran Umum Automasi UI