Bagikan melalui

Tipe Kontrol Bilah Gulir

  • Artikel

Topik ini menyediakan informasi tentang dukungan Microsoft UI Automation untuk jenis kontrol ScrollBar .

Kontrol bilah gulir memungkinkan pengguna untuk menggulir konten di dalam jendela atau kontainer item. Kontrol terdiri dari sekumpulan tombol dan kontrol jempol.

Bagian berikut menentukan struktur pohon, properti, pola kontrol, dan peristiwa Automation UI yang diperlukan untuk jenis kontrol ScrollBar . Persyaratan Otomatisasi UI berlaku untuk semua kontrol bilah gulir tempat kerangka kerja/platform UI mengintegrasikan dukungan Automation UI untuk jenis kontrol dan pola kontrol.

Topik ini berisi bagian berikut.

Struktur Pohon Umum

Tabel berikut ini menggambarkan kontrol umum 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 UI Automation, lihat Ringkasan Pohon UI Automation.

Tampilan Kontrol Tampilan Konten
  • ScrollBar
    • Tombol (0, 2, atau 4)
    • Jempol (0 atau 1)
 Tidak dapat diterapkan. (Kontrol bilah gulir tidak memiliki konten.)

 

Kontrol bilah gulir dapat memiliki nol hingga lima anak. Karena subtree memiliki lebih dari satu kontrol tombol, elemen harus mengatur nilai UIA_AutomationIdPropertyId tertentu ke setiap item agar dapat ditemukan untuk alat pengujian otomatis.

Properti yang Relevan

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; fungsionalitasnya diekspos melalui pola kontrol Gulir , yang didukung pada kontainer yang sedang digulirkan.

Untuk informasi selengkapnya tentang properti Automation UI, lihat Mengambil Properti dari Elemen Automation UI.

Properti UI Automation Nilai Catatan
UIA_AutomationIdPropertyId Lihat catatan. Nilai properti ini harus unik di antara semua elemen serekan dalam tampilan mentah pohon Automation UI.
UIA_BoundingRectanglePropertyId Lihat catatan. Persegi panjang terluar yang berisi seluruh kontrol.
UIA_ClickablePointPropertyId NaN Kontrol bilah gulir tidak memiliki titik yang dapat diklik.
UIA_ControlTypePropertyId ScrollBar Nilai ini sama untuk semua kerangka kerja. Bilah gulir yang berfungsi sebagai penggelser harus menggunakan tipe kontrol Slider .
UIA_IsContentElementPropertyId FALSE Kontrol bilah gulir tidak pernah menjadi elemen konten. Jika bilah gulir adalah kontrol mandiri, bilah gulir harus memenuhi jenis kontrol Slider dan mengembalikan UIA_SliderControlTypeId untuk properti IUIAutomationElement::CurrentControlType (atau CachedControlType).
UIA_IsControlElementPropertyId TRUE Kontrol bilah gulir selalu disertakan dalam tampilan kontrol pohon Automation UI.
UIA_IsKeyboardFocusablePropertyId Lihat catatan. Jika kontrol dapat menerima fokus keyboard, maka kontrol harus mendukung properti ini. Kontrol bilah gulir jarang mengambil fokus, tetapi ketika itu terjadi, fokus harus tetap pada kontrol bilah gulir itu sendiri, bukan pada tombol anak atau jempol. Pengguna harus dapat melakukan semua tindakan gulir dengan menggunakan tombol PANAH ATAS dan PANAH BAWAH (atau PANAH KANAN dan PANAH KIRI), atau tombol PAGE UP dan PAGE DOWN.
UIA_LabeledByPropertyId NULL Bilah gulir tidak memiliki label.
UIA_LocalizedControlTypePropertyId Lihat catatan. String yang dilokalkan sesuai dengan jenis kontrol ScrollBar . Nilai defaultnya adalah "bilah gulir" untuk en-US atau English (Amerika Serikat).
UIA_NamePropertyId NULL Kontrol bilah gulir tidak memiliki elemen konten dan properti UIA_NamePropertyId tidak perlu diatur.
UIA_OrientationPropertyId Lihat catatan. Kontrol bilah gulir harus selalu mengekspos orientasi horizontal atau vertikalnya.

 

Pola Kontrol yang Diperlukan

Tabel berikut mencantumkan pola kontrol Automation UI yang diperlukan untuk didukung oleh semua kontrol bilah gulir. Untuk informasi selengkapnya tentang pola kontrol, lihat Gambaran Umum Pola Kontrol UI Automation.

Catatan

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
IRangeValueProvider Bergantung Pola kontrol RangeValue diperlukan untuk didukung hanya jika pola kontrol Gulir tidak didukung pada kontainer yang memiliki bilah gulir.
IScrollProvider Tidak pernah Pola kontrol Gulir tidak pernah didukung secara langsung pada bilah gulir.

 

Peristiwa yang Diperlukan

Tabel berikut mencantumkan peristiwa Automasi UI yang diperlukan kontrol bilah gulir untuk mendukungnya. Untuk informasi selengkapnya tentang peristiwa, lihat Gambaran Umum Peristiwa UI Automation.

Peristiwa UI Automation Catatan
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId peristiwa yang diubah properti.
UIA_IsEnabledPropertyId peristiwa yang diubah properti. Jika kontrol mendukung properti IsEnabled , kontrol harus mendukung peristiwa ini.
UIA_IsOffscreenPropertyId peristiwa yang diubah properti. Jika kontrol mendukung properti IsOffscreen , kontrol harus mendukung peristiwa ini.
UIA_StructureChangedEventId
UIA_RangeValueValuePropertyId peristiwa yang diubah properti. Jika kontrol mendukung pola kontrol RangeValue , kontrol tersebut harus mendukung kejadian ini.

 

Konseptual

Gambaran Umum Jenis Kontrol UI Automation

Gambaran Umum UI Automation