Dukungan UI Automation untuk Jenis Kontrol Kalender
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 Kalender. Dalam UI Automation, jenis kontrol adalah kumpulan kondisi yang harus dipenuhi kontrol untuk menggunakan properti ControlTypeProperty. Ketentuan tersebut mencakup panduan khusus untuk struktur pohon UI Automation, nilai properti UI Automation, pola kontrol, dan peristiwa UI Automation.
Kontrol kalender memungkinkan pengguna untuk dengan mudah menentukan tanggal dan memilih tanggal lainnya.
Bagian berikut menentukan struktur pohon UI Automation yang diperlukan, properti, pola kontrol, dan peristiwa untuk jenis kontrol Kalender. Persyaratan UI Automation berlaku untuk semua kontrol kalender, 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 kalender 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 |
|---|---|
Calendar
|
Calendar - ListItem (jumlah tergantung pada berapa hari ditampilkan) |
Kontrol kalender dapat direpresentasikan dalam berbagai bentuk dalam antarmuka pengguna. Satu-satunya kontrol yang dijamin untuk berada dalam tampilan kontrol dari struktur UI Automation adalah kontrol kisi data, header, item header, dan item daftar.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti UI Automation yang nilai atau definisinya sangat relevan dengan kontrol kalender. 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. |
| ControlTypeProperty | Calendar | Nilai ini sama untuk semua kerangka kerja UI. |
| IsContentElementProperty | Benar | Kontrol kalender selalu disertakan dalam tampilan konten pohon UI Automation. |
| IsControlElementProperty | Benar | Kontrol kalender 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. | Label kontrol dokumen. Biasanya, judul dokumen digunakan. |
| LocalizedControlTypeProperty | "kalender" | String yang dilokalkan sesuai dengan jenis kontrol Kalender. |
| NameProperty | Lihat catatan. | Kontrol kalender biasanya mendapatkan namanya dari tanggal hari ini. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang diperlukan untuk didukung oleh semua kontrol kalender. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna.
| Pola Kontrol/Properti Pola | Dukungan | Catatan |
|---|---|---|
| IGridProvider | Ya | Kontrol kalender selalu mendukung pola Grid karena hari dalam satu bulan adalah item yang dapat dinavigasi secara spasial. |
| IScrollProvider | Bergantung | Sebagian besar kontrol kalender mendukung membalik tampilan berdasarkan halaman. Pola Gulir direkomendasikan untuk mendukung navigasi penomoran halaman. |
| ISelectionProvider | Bergantung | Sebagian besar kontrol kalender mempertahankan hari, bulan, atau tahun tertentu sebagai pilihan sub-elemen. Beberapa kalender bersifat dapat dipilih dengan banyak dan lainnya hanya dapat dipilih satu saja. |
| ITableProvider | Ya | Kontrol kalender selalu memiliki header di dalam sub-pohonnya untuk hari dalam seminggu, sehingga pola Tabel harus didukung. |
| IValueProvider | No | Pola kontrol nilai tidak diperlukan untuk kontrol kalender karena Anda tidak dapat mengatur nilai secara langsung pada kontrol. Jika tanggal tertentu dikaitkan dengan kontrol, informasi harus disediakan oleh pola kontrol Seleksi. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa UI Automation yang diperlukan untuk didukung oleh semua kontrol kalender. 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 |
| LayoutInvalidatedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |
| CurrentViewProperty peristiwa perubahan properti. | Bergantung | Tidak |
| HorizontallyScrollableProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola kontrol Gulir, kontrol harus mendukung peristiwa ini. |
| HorizontalScrollPercentProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola kontrol Gulir, kontrol harus mendukung peristiwa ini. |
| HorizontalViewSizeProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola kontrol Gulir, kontrol harus mendukung peristiwa ini. |
| VerticalScrollPercentProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola kontrol Gulir, kontrol harus mendukung peristiwa ini. |
| VerticallyScrollableProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola kontrol Gulir, kontrol harus mendukung peristiwa ini. |
| VerticalViewSizeProperty peristiwa perubahan properti. | Bergantung | Jika kontrol mendukung pola kontrol Gulir, kontrol harus mendukung peristiwa ini. |
| InvalidatedEvent | Wajib | Tidak |