Dukungan UI Automation untuk Jenis Kontrol Teks
Catatan
Dokumentasi ini ditujukan untuk pengembang .NET Framework yang ingin menggunakan kelas UI Automation terkelola yang ditentukan pada namespace System.Windows.Automation. Untuk informasi terbaru tentang UI Automation, lihat API Automasi Windows: Automasi Antarmuka Pengguna.
Topik ini memberikan informasi tentang dukungan UI Automation untuk jenis kontrol Teks. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti dan pola kontrol UI Automation.
Kontrol teks adalah item antarmuka pengguna dasar yang mewakili sepotong teks di layar.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan peristiwa untuk jenis kontrol Teks. Persyaratan UI Automation berlaku untuk semua kontrol teks, baik Windows Presentation Foundation (WPF), Win32, atau Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten dari pohon UI Automation yang berkaitan dengan kontrol teks dan menjelaskan apa yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Teks | Teks (jika konten) |
Kontrol teks dapat digunakan sendiri sebagai label atau sebagai teks statis pada formulir. Kontrol ini juga dapat berada dalam struktur:
ListItem
TreeItem
DataItem
Kontrol teks mungkin tidak ada di Tampilan Konten dari pohon UI Automation karena teks sering ditampilkan melalui NameProperty kontrol lain. Misalnya teks yang digunakan untuk memberi label pada kontrol Kotak Kombo diekspos melalui nilai NameProperty kontrol. Karena kontrol Kotak Kombo ada di tampilan konten Pohon UI Automation, kontrol teks tidak perlu ada di sana. Kontrol teks selalu memiliki 0 turunan dalam tampilan konten
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilainya atau definisinya sangat relevan dengan kontrol teks. Untuk informasi selengkapnya tentang properti UI Automation, lihat Properti UI Automation untuk Klien.
| Properti Automasi UI | Nilai | Catatan |
|---|---|---|
| AutomationIdProperty | Lihat catatan. | Nilai properti ini harus unik di semua kontrol dalam aplikasi. |
| BoundingRectangleProperty | Lihat catatan. | Persegi terluar yang berisi seluruh kontrol. |
| ClickablePointProperty | Lihat catatan. | Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam kotak pembatas dapat diklik, dan Anda melakukan pengujian hit khusus, maka ambil alih dan berikan titik yang dapat diklik. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Lihat catatan. | Nama kontrol bilah teks selalu berupa txt yang ditampilkannya. |
| LabeledByProperty | Null |
Kontrol teks tidak memiliki label teks statis. |
| ControlTypeProperty | Teks | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "teks" | String yang dilokalkan sesuai dengan jenis kontrol teks. |
| IsContentElementProperty | Bergantung | Kontrol teks akan menjadi konten jika berisi informasi yang tidak diekspos di NameProperty kontrol lain. |
| IsControlElementProperty | Benar | Kontrol teks harus selalu menjadi kontrol. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh kontrol teks. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IValueProvider | Tidak pernah | Teks tidak pernah mendukung ValuePattern. Jika teks dapat diedit, ini adalah jenis kontrol Edit. |
| ITextProvider | Bergantung | 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). Tergantung pada kerangka kerja. |
| ITableItemProvider | Bergantung | Jika elemen teks terkandung dalam kontrol Tabel, ini harus didukung. |
| IRangeValueProvider | Bergantung | Jika elemen teks terkandung dalam kontrol tabel, ini harus didukung. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol teks. Untuk mendapatkan informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| TextSelectionChangedEvent | Wajib | Tidak |
| TextChangedEvent | Wajib | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| NameProperty peristiwa perubahan properti. | Wajib | Tidak |
| ValueProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |