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".

Antarmuka IAccessible