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 Dokumen. 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.
Kontrol dokumen memungkinkan pengguna melihat dan memanipulasi beberapa halaman teks. Tidak seperti kontrol edit yang hanya mendukung baris sederhana teks yang tidak diformat, kontrol dokumen dapat menghosting teks yang kaya gaya dan diformat.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Otomasi UI yang diperlukan untuk jenis kontrol Dokumen. Persyaratan Automasi UI berlaku untuk semua kontrol dokumen, 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 dokumen 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 |
|---|---|
| Dokumen - Bervariasi |
Dokumen - Bervariasi |
Properti Otomasi Antarmuka Pengguna yang Dibutuhkan
Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan dengan kontrol dokumen. 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. | 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 Automation UI. |
| IsControlElementProperty | Benar | Kontrol dokumen selalu disertakan dalam tampilan kontrol pohon Automation UI. |
| 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 tipe kontrol Dokumen. |
| NameProperty | Lihat catatan. | Kontrol dokumen biasanya mendapatkan namanya dari nama file tempat dokumen dimuat. Ini sering ditampilkan dalam jendela yang berisi atau judul bingkai. |
Pola Kontrol Automasi UI yang Diperlukan
Tabel berikut mencantumkan pola kontrol Automation UI yang diperlukan untuk didukung oleh kontrol dokumen. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI.
| 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 | Diperlukan | 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 isi kontrol sering menjangkau lebih dari satu halaman. Klien Automation UI harus menggunakan TextPattern untuk mendapatkan informasi teks tentang dokumen. |
Peristiwa Automasi UI yang Diperlukan
Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan untuk didukung oleh semua kontrol dokumen. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| AutomationFocusChangedEvent | Diperlukan | Tidak ada |
| BoundingRectangleProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsEnabledProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsOffscreenProperty acara perubahan properti. | Diperlukan | Tidak ada |
| StructureChangedEvent | Diperlukan | Tidak ada |
| HorizontallyScrollableProperty acara perubahan properti. | Diperlukan | Tidak ada |
| HorizontalScrollPercentProperty acara perubahan properti. | Diperlukan | Tidak ada |
| HorizontalViewSizeProperty acara perubahan properti. | Diperlukan | Tidak ada |
| VerticalScrollPercentProperty acara perubahan properti. | Diperlukan | Tidak ada |
| VerticallyScrollableProperty acara perubahan properti. | Diperlukan | Tidak ada |
| VerticalViewSizeProperty acara perubahan properti. | Diperlukan | Tidak ada |
| InvalidatedEvent | Bergantung | Jika elemen mendukung pola kontrol Seleksi, maka elemen tersebut harus mendukung peristiwa ini. |
| TextSelectionChangedEvent | Diperlukan | Tidak ada |
| TextChangedEvent | Diperlukan | Tidak ada |
| ValueProperty acara perubahan properti. | Tidak pernah | Tidak ada |