Dukungan Automasi Antarmuka Pengguna untuk Jenis Kontrol ScrollBar
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 ScrollBar. 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 gulir memungkinkan pengguna untuk menggulir konten di dalam jendela atau kontainer item. Kontrol terdiri dari satu set tombol dan kontrol jempol.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa yang diperlukan Automasi Antarmuka Pengguna untuk jenis kontrol ScrollBar. Persyaratan UI Automation berlaku untuk semua kontrol daftar, 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 gulir 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 |
|---|---|
| ScrollBar - Tombol (2 atau 4) - Jempol (0 atau 1) |
Tidak berlaku. Kontrol bilah gulir tidak berisi konten. |
Kontrol bilah gulir selalu memiliki tiga hingga lima turunan. Karena subtree memiliki lebih dari satu kontrol tombol, Anda harus mengatur nilai AutomationIdProperty tertentu ke setiap item untuk membuatnya dapat ditemukan untuk alat otomatisasi pengujian.
Properti Azure Automation Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan properti Automasi Antarmuka Pengguna yang nilai atau definisinya sangat relevan dengan kontrol bilah gulir. Perhatikan bahwa kontrol bilah gulir tidak pernah memiliki konten; fungsinya diekspos melalui pola kontrol Gulir, yang didukung pada kontainer yang digulir.
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. | Persegi terluar yang berisi seluruh kontrol. |
| IsKeyboardFocusableProperty | Lihat catatan. | Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. |
| NameProperty | Null |
Kontrol bilah gulir tidak memiliki elemen konten dan NameProperty tidak perlu diatur. |
| ClickablePointProperty | Bukan angka. | Kontrol bilah gulir tidak memiliki titik yang dapat diklik. |
| LabeledByProperty | Null |
Bilah gulir tidak memiliki label. |
| ControlTypeProperty | ScrollBar | Nilai ini sama untuk semua kerangka kerja. Bilah gulir yang berfungsi sebagai penggeser harus menggunakan jenis kontrol Penggeser. |
| LocalizedControlTypeProperty | "bilah gulir" | String lokal yang sesuai dengan jenis kontrol Tombol. |
| IsContentElementProperty | Salah | Kontrol bilah gulir tidak pernah menjadi elemen konten. Jika bilah gulir adalah kontrol mandiri, maka bilah gulir harus memenuhi jenis kontrol Penggeser dan mengembalikan ControlType.Slider untuk properti ControlType. |
| IsControlElementProperty | Benar | Bilah gulir harus selalu menjadi kontrol. |
| OrientationProperty | Benar | Kontrol bilah gulir harus selalu mengekspos orientasi horizontal atau vertikalnya. |
Pola Kontrol Automasi Antarmuka Pengguna yang Diperlukan
Tabel berikut mencantumkan pola kontrol Automasi Antarmuka Pengguna yang diperlukan untuk didukung oleh kontrol bilah gulir. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi Antarmuka Pengguna. Perhatikan bahwa ketika bilah gulir digunakan sebagai kontrol untuk manipulasi mouse saja, itu tidak mendukung pola kontrol. Jika digunakan sebagai kontrol penggeser dalam aplikasi, itu harus diberikan jenis kontrol Penggeser.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IScrollProvider | Tidak pernah | Pola kontrol Gulir tidak pernah didukung secara langsung pada bilah gulir. |
| IRangeValueProvider | Bergantung | Fungsi ini hanya diperlukan untuk didukung jika pola kontrol Gulir tidak didukung pada kontainer yang memiliki bilah gulir. |
Peristiwa UI Automation yang Diperlukan
Tabel berikut mencantumkan peristiwa Automasi Antarmuka Pengguna yang harus didukung oleh semua kontrol bilah gulir. Untuk informasi selengkapnya tentang acara, baca Gambaran Umum Peristiwa UI Automation.
| Peristiwa UI Automation | Dukungan/Nilai | Catatan |
|---|---|---|
| BoundingRectangleProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsOffscreenProperty peristiwa perubahan properti. | Wajib | Tidak |
| IsEnabledProperty peristiwa perubahan properti. | Wajib | Tidak |
| HorizontallyScrollableProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| HorizontalScrollPercentProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| HorizontalViewSizeProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| VerticalScrollPercentProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| VerticallyScrollableProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| VerticalViewSizeProperty peristiwa perubahan properti. | Tidak pernah | Tidak |
| ValueProperty peristiwa perubahan properti. | Bergantung | Tidak |
| AutomationFocusChangedEvent | Wajib | Tidak |
| StructureChangedEvent | Wajib | Tidak |