Bilah Gulir (Referensi Elemen UI MSAA)

Catatan

Topik ini menjelaskan objek Bilah Gulir untuk tujuan Referensi Elemen UI MSAA. Cara membuat objek Bilah Gulir di berbagai kerangka kerja UI tidak dijelaskan di sini. Lihat dokumentasi referensi API untuk kerangka kerja UI yang Anda gunakan.

 

Bilah gulir memungkinkan pengguna memilih arah dan jarak untuk menggulir informasi dalam jendela atau kotak daftar terkait. Nama kelas jendela untuk bilah gulir adalah "SCROLLBAR".

Konten properti IAccessible tergantung pada apakah bilah gulir vertikal atau horizontal dan di bagian bilah gulir berikut sedang dikueri oleh klien:

• Bilah gulir itu sendiri
• Tombol panah atas atau kanan
• Tombol panah bawah atau kiri
• Kotak gulir (jempol)
• Halaman ke atas atau wilayah kanan halaman
• Halaman bawah atau wilayah kiri halaman

Metode IAccessible

Bilah gulir mendukung metode IAccessible berikut:

• accDoDefaultAction—Objek bilah gulir itu sendiri dan jempol gulir tidak mendukung metode accDoDefaultAction .

  Untuk bagian bilah gulir lainnya pada bilah gulir vertikal, accDoDefaultAction memanggil PostMessage dengan pesan WM_VSCROLL dengan wParam diatur ke nilai berikut.

  Tombol/Wilayah	Vaule
  Tombol panah atas	SB_LINEUP
  Tombol panah bawah	SB_LINEDOWN
  Wilayah page up	SB_PAGEUP
  Wilayah bawah halaman	SB_PAGEDOWN

   

  Untuk bagian bilah gulir lainnya pada bilah gulir horizontal, accDoDefaultAction memanggil PostMessage dengan pesan WM_HSCROLL dengan wParam diatur ke nilai berikut.

  Tombol/Wilayah	Nilai
  Tombol panah kiri	SB_LINELEFT
  Tombol panah kanan	SB_LINERIGHT
  Wilayah kiri halaman	SB_PAGELEFT
  Wilayah kanan halaman	SB_PAGERIGHT

   

• accHitTest

• accLocation

• accNavigate

Properti IAccessible

Bilah gulir mendukung properti IAccessible berikut:

• get_accChildCount—Properti ChildCount untuk objek bilah gulir adalah lima. Untuk bagian bilah gulir lainnya, properti ChildCount adalah nol.

• get_accDefaultAction—Objek bilah gulir itu sendiri dan jempol gulir tidak mendukung properti DefaultAction . Properti DefaultAction untuk tombol panah dan area ber bayangan di salah satu sisi jempol gulir adalah "Tekan".

• get_accDescription—Properti Deskripsi bergantung pada bagian bilah gulir yang dikueri.

  Bagian bilah gulir vertikal memiliki deskripsi berikut.

  Bagian	Deskripsi
  Bilah gulir itu sendiri	"Digunakan untuk mengubah area tampilan vertikal"
  Tombol panah atas	"Memindahkan posisi vertikal ke atas satu baris"
  Tombol panah bawah	"Memindahkan posisi vertikal ke bawah satu baris"
  Jempol gulir	"Menunjukkan posisi vertikal saat ini, dan dapat diseret untuk mengubahnya secara langsung"
  Wilayah page up	"Memindahkan posisi vertikal ke atas beberapa garis"
  Wilayah bawah halaman	"Menunjukkan posisi vertikal saat ini, dan dapat diseret untuk mengubahnya secara langsung"

   

  Bagian bilah gulir horizontal memiliki deskripsi berikut.

  Bagian	Deskripsi
  Bilah gulir itu sendiri	"Digunakan untuk mengubah area tampilan horizontal"
  Tombol panah kiri	"Memindahkan posisi horizontal ke kiri satu kolom"
  Tombol panah kanan	'Memindahkan posisi horizontal ke kanan satu kolom"
  Jempol gulir	"Menunjukkan posisi horizontal saat ini, dan dapat diseret untuk mengubahnya secara langsung"
  Wilayah kiri halaman	"Memindahkan posisi horizontal ke kiri beberapa kolom"
  Wilayah kanan halaman	"Menunjukkan posisi vertikal saat ini, dan dapat diseret untuk mengubahnya secara langsung"

   

• get_accHelp

• get_accHelpTopic

• get_accName—Properti Nama bergantung pada bagian bilah gulir yang dikueri.

  Bagian bilah gulir vertikal memiliki nama berikut.

  Bagian	Nama
  Jendela bilah gulir	"Vertikal"
  Tombol panah atas	"Line up"
  Tombol panah bawah	"Baris ke bawah"
  Jempol gulir	"Posisi"
  Wilayah page up	"Page up"
  Wilayah bawah halaman	"Page down"

   

  Bagian bilah gulir horizontal memiliki nama berikut.

  Bagian	Nama
  Jendela bilah gulir	"Horizontal"
  Tombol panah kiri	"Kolom kiri"
  Tombol panah kanan	"Kolom kanan"
  Jempol gulir	"Posisi"
  Wilayah kanan halaman	"Halaman kanan"
  Wilayah kiri halaman	"Halaman kiri"

   

• get_accParent—Properti Induk tombol panah, jempol gulir, dan area ber bayangan di kedua sisi ibu jari adalah jendela bilah gulir. Properti Induk dari jendela bilah gulir adalah jendela (ROLE_SYSTEM_WINDOW) yang mengelilingi kontrol dan memiliki properti Nama dan nama kelas jendela yang sama.

• get_accRole—Properti Peran bergantung pada bagian bilah gulir yang dikueri. Bagian bilah gulir memiliki peran berikut.

  Bagian	Peran
  Bilah gulir itu sendiri	ROLE_SYSTEM_SCROLLBAR
  Tombol panah atas, bawah, kiri, dan kanan	ROLE_SYSTEM_PUSHBUTTON
  Jempol gulir	ROLE_SYSTEM_INDICATOR
  Halaman atas, halaman bawah, halaman kiri, dan wilayah kanan halaman	ROLE_SYSTEM_PUSHBUTTON

   

• get_accState—Properti Status dari setiap komponen bilah gulir menyertakan kombinasi nilai berikut.

  Provinsi	Nilai
  STATE_SYSTEM_INVISIBLE	Untuk bilah gulir itu sendiri, ini menunjukkan bilah gulir vertikal atau horizontal yang ditentukan tidak ada. Untuk wilayah halaman atas atau halaman bawah, ini menunjukkan jempol diposisikan sededingin itu wilayah tidak ada.
  STATE_SYSTEM_OFFSCREEN	Untuk bilah gulir itu sendiri, ini menunjukkan jendela berukuran sedingin itu sehingga bilah gulir vertikal atau horizontal yang ditentukan saat ini tidak ditampilkan.
  STATE_SYSTEM_PRESSED	Tombol panah atau wilayah halaman ditekan.
  STATE_SYSTEM_UNAVAILABLE	Komponen dinonaktifkan.

   

• get_accValue—Properti Nilai untuk jendela bilah gulir menunjukkan posisi bilah gulir dan merupakan string yang berisi bilangan bulat dari "0" hingga "100".

Topik terkait

Antarmuka IAccessible