Dukungan Automasi Antarmuka Pengguna untuk Jenis Kontrol TitleBar
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 Automasi Antarmuka Pengguna untuk jenis kontrol TitleBar. 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 bilah judul mewakili judul atau bilah judul di jendela.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa yang diperlukan Automasi Antarmuka Pengguna untuk jenis kontrol TitleBar. Persyaratan Automasi Antarmuka Pengguna berlaku untuk semua kontrol bilah judul, baik Windows Presentation Foundation (WPF), Win32, atau Formulir Windows.
Struktur Pohon UI Automation yang Diperlukan
Tabel berikut menggambarkan tampilan kontrol dan tampilan konten pohon Automasi Antarmuka Pengguna yang berkaitan dengan kontrol bilah judul dan menjelaskan apa yang dapat terkandung dalam setiap tampilan. Untuk informasi selengkapnya tentang pohon UI Automation, lihat Gambaran Umum Pohon UI Automation.
| Tampilan Kontrol | Tampilan Konten |
|---|---|
| TitleBar - Menu (0 atau 1) - Tombol (0 atau lebih) |
Tidak berlaku. (kontrol bilah judul tidak memiliki konten.) |
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti Automasi Antarmuka Pengguna yang nilai atau definisinya sangat relevan dengan kontrol TitleBar. Untuk mendapatkan 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. | Kotak batas dari bilah judul harus mencakup semua kontrol yang terkandung di dalamnya. |
| 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 | Salah | Bilah judul tidak pernah memiliki fokus keyboard. |
| NameProperty | "" | Bilah judul tidak puas; informasi tekstualnya diekspos pada jendela induk. |
| LabeledByProperty | Lihat catatan. | Kontrol bilah judul biasanya tidak memiliki label. |
| ControlTypeProperty | TitleBar | Nilai ini sama untuk semua kerangka kerja UI. |
| LocalizedControlTypeProperty | "bilah judul" | String terlokalisasi yang sesuai dengan jenis kontrol TitleBar. |
| IsContentElementProperty | Salah | Kontrol bilah judul tidak pernah konten. |
| IsControlElementProperty | Benar | Kontrol bilah judul harus selalu menjadi kontrol. |
| IsOffscreenProperty | Bergantung | Kontrol ini akan mengembalikan nilai tergantung pada apakah bilah judul terlihat di layar. |
| HelpTextProperty | "" | Tidak perlu mengekspos teks Bantuan. |
| AcceleratorKeyProperty | "" | Bilah judul tidak pernah memiliki kunci akselerator. |
| AccessKeyProperty | "" | Kontrol bilah judul tidak memiliki kunci akses. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Jenis kontrol TitleBar tidak diperlukan untuk mendukung pola kontrol apa pun. Fungsinya diekspos melalui pola Kontrol jendela pada Kontrol jendela.
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa Automasi Antarmuka Pengguna yang harus didukung oleh semua kontrol bilah judul. Untuk mendapatkan informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan | Catatan |
|---|---|---|
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| AutomationFocusChangedEvent | Tidak pernah | Tidak |
| StructureChangedEvent | Wajib | Tidak |