Полоса прокрутки (справочник по элементу пользовательского интерфейса MSAA)

Заметка

В этом разделе описывается объектах полосы прокрутки для ссылок на элемент пользовательского интерфейса MSAA. Создание объектов полосы прокрутки в различных платформах пользовательского интерфейса не описано здесь. См. справочную документацию по API для используемой платформы пользовательского интерфейса.

 

Полосы прокрутки позволяют пользователю выбирать направление и расстояние для прокрутки информации в связанном окне или списке. Имя класса окна для полосы прокрутки — SCROLLBAR.

Содержимое свойств IAccessible зависит от того, вертикальная или горизонтальная полоса прокрутки, а также от того, какие из следующих частей полосы прокрутки запрашиваются клиентом:

  • Сама полоса прокрутки
  • Кнопка со стрелкой вверху или вправо
  • Кнопка со стрелкой вниз или влево
  • Поле прокрутки (большой палец)
  • Страница вверх или правый регион страницы
  • Страница вниз или в левой области страницы

Недоступные методы

Полоса прокрутки поддерживает следующие методы IAccessible:

  • accDoDefaultAction— сам объект полосы прокрутки и палец прокрутки не поддерживают метод accDoDefaultAction.

    Для других частей полосы прокрутки на вертикальной полосе прокрутки accDoDefaultAction вызовы PostMessage с сообщением WM_VSCROLL с wParam заданы следующие значения.

    Кнопка или регион Ваул
    Кнопка со стрелкой сверху SB_LINEUP
    Кнопка со стрелкой вниз SB_LINEDOWN
    Регион страницы вверх SB_PAGEUP
    Область вниз страницы SB_PAGEDOWN

     

    Для других частей полосы прокрутки на горизонтальной полосе прокрутки accDoDefaultAction вызовы PostMessage с сообщением WM_HSCROLL с wParam заданы следующие значения.

    Кнопка или регион Ценность
    Кнопка стрелка влево SB_LINELEFT
    Кнопка стрелка вправо SB_LINERIGHT
    Область слева на странице SB_PAGELEFT
    Правый регион страницы SB_PAGERIGHT

     

  • accHitTest

  • accLocation

  • accNavigate

Свойства IAccessible

Полоса прокрутки поддерживает следующие свойства IAccessible:

  • get_accChildCount— свойство ChildCount для объекта полосы прокрутки равно пяти. Для других частей полосы прокрутки свойство ChildCount равно нулю.

  • get_accDefaultAction— сам объект полосы прокрутки и палец прокрутки не поддерживают свойство DefaultAction. Свойство DefaultAction для кнопок со стрелками и затененных областей на обеих сторонах прокрутки — "Нажмите".

  • get_accDescription— свойство описания зависит от части запрашиваемой полосы прокрутки.

    Части вертикальной полосы прокрутки содержат следующие описания.

    Часть Описание
    Полоса прокрутки сама "Используется для изменения вертикальной области просмотра"
    Кнопка со стрелкой сверху "Перемещение вертикальной позиции вверх по одной строке"
    Кнопка со стрелкой вниз "Перемещение вертикальной позиции вниз по одной строке"
    Прокрутите пальцем "Указывает текущую вертикальную позицию и можно перетаскивать, чтобы изменить ее напрямую".
    Регион страницы вверх "Перемещает вертикальную позицию вверх по паре строк"
    Область вниз страницы "Указывает текущую вертикальную позицию и можно перетаскивать, чтобы изменить ее напрямую".

     

    Части горизонтальной полосы прокрутки содержат следующие описания.

    Часть Описание
    Полоса прокрутки сама "Используется для изменения горизонтальной области просмотра"
    Кнопка стрелка влево "Перемещение горизонтальной позиции влево из одного столбца"
    Кнопка стрелка вправо Перемещение горизонтальной позиции вправо по одному столбцу
    Прокрутите пальцем "Указывает текущую горизонтальную позицию и можно перетаскивать, чтобы изменить ее напрямую".
    Область слева на странице "Перемещение горизонтальной позиции влево с несколькими столбцами"
    Правый регион страницы "Указывает текущую вертикальную позицию и можно перетаскивать, чтобы изменить ее напрямую".

     

  • get_accHelp

  • get_accHelpTopic

  • get_accName— свойство имени зависит от части запрашиваемой полосы прокрутки.

    Части вертикальной полосы прокрутки имеют следующие имена.

    Часть Имя
    Окно полосы прокрутки "Вертикальная"
    Кнопка со стрелкой сверху "Выстраивать"
    Кнопка со стрелкой вниз "Строка вниз"
    Прокрутите пальцем "Позиция"
    Регион страницы вверх "Страница вверх"
    Область вниз страницы "Страница вниз"

     

    Части горизонтальной полосы прокрутки имеют следующие имена.

    Часть Имя
    Окно полосы прокрутки "Горизонтально"
    Кнопка стрелка влево "Столбец слева"
    Кнопка стрелка вправо "Столбец справа"
    Прокрутите пальцем "Позиция"
    Правый регион страницы "Страница справа"
    Область слева на странице "Страница слева"

     

  • get_accParent— свойство родительского кнопок со стрелками, палец прокрутки и затененная область на обеих сторонах пальца — это окно полосы прокрутки. Свойство Parent окна полосы прокрутки — это окно (ROLE_SYSTEM_WINDOW), которое окружает элемент управления и имеет то же Имя свойства и имени класса окна.

  • get_accRole— свойство роли зависит от части запрашиваемой полосы прокрутки. Части полосы прокрутки имеют следующие роли.

    Часть Роль
    Полоса прокрутки сама ROLE_SYSTEM_SCROLLBAR
    Кнопки сверху, вниз, влево и вправо ROLE_SYSTEM_PUSHBUTTON
    Прокрутите пальцем ROLE_SYSTEM_INDICATOR
    Вверх, страница вниз, слева и справа на странице ROLE_SYSTEM_PUSHBUTTON

     

  • get_accState— свойство состояния каждого компонента полосы прокрутки включает сочетание следующих значений .

    Государство Ценность
    STATE_SYSTEM_INVISIBLE Для самой полосы прокрутки это означает, что указанная вертикальная или горизонтальная полоса прокрутки не существует. Для областей вверх или вниз страницы это означает, что палец расположен таким образом, чтобы регион не существовал.
    STATE_SYSTEM_OFFSCREEN Для самой полосы прокрутки это означает, что окно имеет размер, так что указанная вертикальная или горизонтальная полоса прокрутки в настоящее время не отображается.
    STATE_SYSTEM_PRESSED Нажимается кнопка со стрелкой или область страницы.
    STATE_SYSTEM_UNAVAILABLE Компонент отключен.

     

  • get_accValue— свойство значение для окна полосы прокрутки указывает позицию полосы прокрутки и представляет собой строку, содержащую целое число от "0" до "100".

интерфейс IAccessible