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 ScrollBar. Di Automasi UI, jenis kontrol adalah serangkaian kondisi yang harus dipenuhi kontrol untuk menggunakan ControlTypeProperty properti . Kondisi ini mencakup pedoman khusus untuk struktur pohon UI Automation, nilai properti UI Automation, dan pola kontrol.
Kontrol bilah gulir memungkinkan pengguna untuk menggulir konten dalam jendela atau kontainer item. Kontrol terdiri dari sekumpulan tombol dan kontrol jempol.
Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Otomasi UI yang diperlukan untuk jenis kontrol ScrollBar. Persyaratan Otomatisasi UI berlaku untuk semua kontrol daftar, 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 bilah gulir 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 |
|---|---|
| Bilah Gulir - Tombol (2 atau 4) - Jempol (0 atau1) |
Tidak dapat diterapkan. Kontrol bilah gulir tidak memuat isi. |
Kontrol bilah gulir selalu memiliki tiga hingga lima anak. Karena subtree memiliki lebih dari satu kontrol tombol, Anda harus mengatur nilai tertentu AutomationIdProperty ke setiap item untuk membuatnya dapat ditemukan untuk alat otomatisasi pengujian.
Properti Otomasi Antarmuka Pengguna yang Dibutuhkan
Tabel berikut mencantumkan properti Automation UI yang nilai atau definisinya sangat relevan untuk kontrol bilah gulir. Perhatikan bahwa kontrol bilah gulir tidak pernah memiliki konten; fungsionalitasnya diekspos melalui pola kontrol Gulir, yang didukung pada kontainer yang sedang digulir.
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. |
| 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 | Bilah Gulir | Nilai ini sama untuk semua kerangka kerja. Bilah gulir yang berfungsi sebagai penggelser harus menggunakan tipe kontrol Slider. |
| LocalizedControlTypeProperty | "bilah gulir" | String yang dilokalkan yang sesuai dengan tipe kontrol Tombol. |
| IsContentElementProperty | Tidak benar | Kontrol bilah gulir tidak pernah menjadi elemen konten. Jika bilah gulir adalah kontrol independen, maka harus memenuhi jenis kontrol Slider dan mengembalikan ControlType.Slider untuk properti ControlType. |
| IsControlElementProperty | Benar | Bilah gulir harus selalu berfungsi sebagai kontrol. |
| OrientationProperty | Benar | Kontrol bilah gulir harus selalu mengekspos orientasi horizontal atau vertikalnya. |
Pola Kontrol Automasi UI yang Diperlukan
Tabel berikut mencantumkan pola kontrol UI Automation yang harus didukung oleh kontrol bilah gulir. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol Automasi UI . Perhatikan bahwa ketika bilah gulir digunakan sebagai kontrol untuk manipulasi mouse saja, bilah gulir tidak mendukung pola kontrol. Jika digunakan sebagai kontrol slider dalam aplikasi, itu harus diberikan jenis kontrol Slider.
| Pola Kontrol | Dukungan | Catatan |
|---|---|---|
| IScrollProvider | Tidak pernah | Pola kontrol Gulir tidak pernah didukung secara langsung pada bilah gulir. |
| IRangeValueProvider | Bergantung | Fungsionalitas ini diperlukan untuk didukung hanya jika pola kontrol Gulir tidak didukung pada kontainer yang memiliki bilah gulir. |
Peristiwa Automasi UI yang Diperlukan
Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan untuk didukung oleh semua kontrol bilah gulir. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa Automasi UI .
| Peristiwa UI Automation | Dukungan/Nilai | Catatan |
|---|---|---|
| BoundingRectangleProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsOffscreenProperty acara perubahan properti. | Diperlukan | Tidak ada |
| IsEnabledProperty acara perubahan properti. | Diperlukan | Tidak ada |
| HorizontallyScrollableProperty acara perubahan properti. | Tidak pernah | Tidak ada |
| HorizontalScrollPercentProperty acara perubahan properti. | Tidak pernah | Tidak ada |
| HorizontalViewSizeProperty acara perubahan properti. | Tidak pernah | Tidak ada |
| VerticalScrollPercentProperty acara perubahan properti. | Tidak pernah | Tidak ada |
| VerticallyScrollableProperty acara perubahan properti. | Tidak pernah | Tidak ada |
| VerticalViewSizeProperty acara perubahan properti. | Tidak pernah | Tidak ada |
| ValueProperty acara perubahan properti. | Bergantung | Tidak ada |
| AutomationFocusChangedEvent | Diperlukan | Tidak ada |
| StructureChangedEvent | Diperlukan | Tidak ada |