Dukungan UI Automation untuk Jenis Kontrol Dokumen
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 Dokumen. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Kondisi ini mencakup panduan khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan pola kontrol.
Kontrol dokumen memungkinkan pengguna melihat dan memanipulasi beberapa halaman teks. Tidak seperti kontrol pengeditan yang hanya mendukung baris sederhana teks yang tidak diformat, kontrol dokumen dapat menghosting teks yang kaya gaya dan diformat.
Bagian berikut menentukan struktur pohon UI Automation, properti, pola kontrol, dan peristiwa yang diperlukan untuk jenis kontrol Dokumen. Persyaratan UI Automation berlaku untuk semua kontrol daftar, baik Windows Presentation Foundation (WPF), Win32, maupun Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten dari pohon UI Automation yang berkaitan dengan kontrol dokumen dan menjelaskan yang dapat dimuat dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Ringkasan Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| Dokumen - Bervariasi |
Dokumen - Bervariasi |
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol dokumen. 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. | Dokumen memiliki titik yang dapat diklik yang akan menyebabkan dokumen salah satu elemennya dalam kontainer dokumen memiliki fokus. |
| ControlTypeProperty | Dokumen | Nilai ini sama untuk semua kerangka kerja UI. |
| IsContentElementProperty | Benar | Kontrol dokumen selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsControlElementProperty | Benar | Kontrol dokumen selalu disertakan dalam tampilan kontrol pohon UI Automation. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| LabeledByProperty | Lihat catatan. | Nilai properti ini harus menjadi label kontrol dokumen. Biasanya, judul dokumen digunakan. |
| LocalizedControlTypeProperty | “dokumen” | String yang dilokalkan yang sesuai dengan jenis kontrol Dokumen. |
| NameProperty | Lihat catatan. | Kontrol dokumen biasanya mendapatkan namanya dari nama file tempat dokumen dimuat. Sering kali ditampilkan dalam judul jendela atau bingkai yang dimuat. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh kontrol dokumen. Untuk mendapatkan informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IScrollProvider | Bergantung | Kontrol dokumen dapat menjangkau lebih besar dari rentang viewport tersebut. Kontrol harus mendukung pola kontrol Gulir jika konten dapat digulir. |
| ITextProvider | Wajib | Kontrol dokumen dapat menjangkau lebih besar dari rentang viewport tersebut. Kontrol harus mendukung pola kontrol Gulir jika konten dapat digulir. |
| IValueProvider | Tidak pernah | Kontrol dokumen tidak mendukung pola kontrol ini karena konten kontrol sering kali menjangkau lebih dari satu halaman. Klien UI Automation harus menggunakan TextPattern untuk mendapatkan informasi teks tentang dokumen. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol dokumen. Untuk mendapatkan informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| AutomationFocusChangedEvent | Wajib | Tidak |
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |
| HorizontallyScrollableProperty peristiwa perubahan properti. | Wajib | Tidak |
| HorizontalScrollPercentProperty peristiwa perubahan properti. | Wajib | Tidak |
| HorizontalViewSizeProperty peristiwa perubahan properti. | Wajib | Tidak |
| VerticalScrollPercentProperty peristiwa perubahan properti. | Wajib | Tidak |
| VerticallyScrollableProperty peristiwa perubahan properti. | Wajib | Tidak |
| VerticalViewSizeProperty peristiwa perubahan properti. | Wajib | Tidak |
| InvalidatedEvent | Bergantung | Jika kontrol mendukung pola kontrol Pilihan, kontrol harus mendukung peristiwa ini. |
| TextSelectionChangedEvent | Wajib | Tidak |
| TextChangedEvent | Wajib | Tidak |
| ValueProperty peristiwa perubahan properti. | Tidak pernah | Tidak |