Bilah Gulir (Referensi Elemen UI MSAA)

Nota

Topik ini menjelaskan Bilah Gulir objek untuk tujuan Referensi Elemen UI MSAA. Cara membuat Scroll Bar objek dalam 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 propertiIAccessible tergantung pada apakah bilah gulir vertikal atau horizontal dan di bagian mana dari 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 atas atau wilayah kanan halaman
  • Halaman bawah atau halaman kiri wilayah

Metode IAccessible

Bilah gulir mendukung metodeIAccessible berikut:

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

    Untuk bagian bilah gulir lainnya pada bilah gulir vertikal, accDoDefaultAction panggilan 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 page down SB_PAGEDOWN

     

    Untuk bagian bilah gulir lainnya pada bilah gulir horizontal, panggilan accDoDefaultAction 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 propertiIAccessible berikut ini:

  • 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 kedua sisi ibu jari 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"
    Gulir jempol "Menunjukkan posisi vertikal saat ini, dan dapat diseret untuk mengubahnya secara langsung"
    Wilayah page up "Memindahkan posisi vertikal ke atas beberapa baris"
    Wilayah page down "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"
    Gulir jempol "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 "Berbaris"
    Tombol panah bawah "Baris ke bawah"
    Gulir jempol "Posisi"
    Wilayah page up "Page up"
    Wilayah page down "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"
    Gulir jempol "Posisi"
    Wilayah kanan halaman "Halaman kanan"
    Wilayah kiri halaman "Halaman kiri"

     

  • get_accParent—Properti Induk tombol panah, jempol gulir, dan area berteduh 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 Peranan
    Bilah gulir itu sendiri ROLE_SYSTEM_SCROLLBAR
    Tombol panah atas, bawah, kiri, dan kanan ROLE_SYSTEM_PUSHBUTTON
    Gulir jempol ROLE_SYSTEM_INDICATOR
    Halaman atas, halaman bawah, kiri halaman, dan wilayah kanan halaman ROLE_SYSTEM_PUSHBUTTON

     

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

    Negara 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 bawah halaman, ini menunjukkan jempol diposisikan sedih sehingga wilayah tidak ada.
    STATE_SYSTEM_OFFSCREEN Untuk bilah gulir itu sendiri, ini menunjukkan jendela berukuran sedih 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