Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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 Teks. Di Automasi UI, jenis kontrol adalah serangkaian kondisi yang harus dipenuhi kontrol untuk menggunakan ControlTypeProperty properti . Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan pola kontrol.
Kontrol teks adalah item antarmuka pengguna dasar yang mewakili sepotong teks di layar.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Otomasi UI yang diperlukan untuk jenis kontrol Teks. Persyaratan Automasi UI berlaku untuk semua kontrol teks, 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 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 terkandung dalam struktur:
Daftar Item
TreeItem
DataItem
Kontrol teks mungkin tidak ada di pohon Tampilan Konten UI Automation karena teks sering kali ditampilkan melalui NameProperty oleh kontrol lain. Misalnya teks yang digunakan untuk memberi label kontrol Kotak Kombo diekspos melalui nilai kontrol NameProperty . Karena kontrol Kotak Kombo berada dalam tampilan konten Pohon Automasi UI, kontrol teks tidak perlu berada di sana. Kontrol teks tidak pernah memiliki anak elemen dalam tampilan konten
Properti Otomasi Antarmuka Pengguna yang Dibutuhkan
Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol teks. 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 terluar yang berisi seluruh kontrol. |
| ClickablePointProperty | Lihat catatan. | Didukung jika ada persegi panjang pembatas. Jika tidak setiap titik dalam persegi panjang 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 merupakan 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 terlihat di NameProperty kontrol lain. |
| IsControlElementProperty | Benar | Kontrol teks harus selalu menjadi kontrol. |
Pola Kontrol Automasi UI 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 | 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 Automasi UI yang Diperlukan
Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan untuk didukung oleh semua kontrol teks. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| 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. | Tidak pernah | Tidak ada |
| AutomationFocusChangedEvent | Diperlukan | Tidak ada |
| StructureChangedEvent | Diperlukan | Tidak ada |