Полоса прокрутки (справочник по элементам пользовательского интерфейса MSAA)
Примечание
В этом разделе описываются объекты полосы прокрутки для справки по элементам пользовательского интерфейса MSAA. Создание объектов полосы прокрутки в различных платформах пользовательского интерфейса не описывается здесь. См. справочную документацию по API для используемой платформы пользовательского интерфейса.
Полосы прокрутки позволяют пользователю выбрать направление и расстояние для прокрутки информации в связанном окне или списке. Имя класса окна для полосы прокрутки — SCROLLBAR.
Содержимое свойств IAccessible зависит от того, является ли полоса прокрутки вертикальной или горизонтальной, а также от того, какая из следующих частей полосы прокрутки запрашивается клиентом:
- Сама полоса прокрутки
- Верхняя или правая кнопка со стрелкой
- Кнопка со стрелкой внизу или влево
- Поле прокрутки (большой палец)
- Страница вверх или правая область страницы
- Внизу страницы или в левой области страницы
Методы IAccessible
Полоса прокрутки поддерживает следующие методы IAccessible :
accDoDefaultAction — сам объект полосы прокрутки и большой палец прокрутки не поддерживают метод accDoDefaultAction .
Для других частей полосы прокрутки на вертикальной полосе прокрутки accDoDefaultAction вызывает PostMessage с сообщением WM_VSCROLL , при этом wParam имеет следующие значения.
Кнопка или регион Ваул Кнопка со стрелкой сверху SB_LINEUP Кнопка со стрелкой внизу SB_LINEDOWN Регион page up SB_PAGEUP Регион страницы вниз SB_PAGEDOWN Для других частей полосы прокрутки на горизонтальной полосе прокрутки accDoDefaultAction вызывает PostMessage с WM_HSCROLL сообщением с wParam , заданными следующими значениями.
Кнопка или регион Значение Кнопка со стрелкой влево SB_LINELEFT Кнопка со стрелкой вправо SB_LINERIGHT Область страницы слева SB_PAGELEFT Регион справа на странице SB_PAGERIGHT
Свойства IAccessible
Полоса прокрутки поддерживает следующие свойства IAccessible :
get_accChildCount — свойство ChildCount для объекта полосы прокрутки равно пяти. Для других частей полосы прокрутки свойство ChildCount равно нулю.
get_accDefaultAction — сам объект полосы прокрутки и большой палец прокрутки не поддерживают свойство DefaultAction . Свойство DefaultAction для кнопок со стрелками и затененных областей по обе стороны от большого пальца прокрутки имеет значение "Нажмите".
get_accDescription — свойство Description зависит от запрашиваемой части полосы прокрутки.
Части вертикальной полосы прокрутки имеют следующие описания.
Часть Описание Сама полоса прокрутки "Используется для изменения вертикальной области просмотра" Кнопка со стрелкой сверху "Перемещение вертикального положения вверх на одну строку" Кнопка со стрелкой внизу "Перемещение вертикальной позиции вниз на одну строку" Прокрутка большого пальца "Указывает текущее положение по вертикали, и его можно перетащить, чтобы изменить его напрямую" Регион page up "Перемещение вертикального положения вверх на пару линий" Регион страницы вниз "Указывает текущее положение по вертикали, и его можно перетащить, чтобы изменить его напрямую" Части горизонтальной полосы прокрутки имеют следующие описания.
Часть Описание Сама полоса прокрутки "Используется для изменения области горизонтального просмотра" Кнопка со стрелкой влево "Перемещение горизонтального положения влево на один столбец" Кнопка со стрелкой вправо 'Перемещение горизонтальной позиции вправо на один столбец" Прокрутка большого пальца "Указывает текущее горизонтальное положение, и его можно перетащить, чтобы изменить его напрямую" Область страницы слева "Перемещение горизонтального положения влево на пару столбцов" Регион справа на странице "Указывает текущее положение по вертикали, и его можно перетащить, чтобы изменить его напрямую" get_accName — свойство Name зависит от запрашиваемой части полосы прокрутки.
Части вертикальной полосы прокрутки имеют следующие имена.
Часть Имя Окно полосы прокрутки "Вертикальный" Кнопка со стрелкой сверху "Выстраивать" Кнопка со стрелкой внизу "Строка вниз" Прокрутка большого пальца "Позиция" Регион page up "Page up" Регион страницы вниз "Page down" Части горизонтальной полосы прокрутки имеют следующие имена.
Часть Имя Окно полосы прокрутки "Горизонтальный" Кнопка со стрелкой влево "Столбец слева" Кнопка со стрелкой вправо "Столбец справа" Прокрутка большого пальца "Позиция" Регион справа на странице "Страница вправо" Область страницы слева "Страница слева" get_accParent — свойство Parent кнопок со стрелками, бегунка прокрутки и затеняемой области по обе стороны от большого пальца является окном полосы прокрутки. Свойство Parent окна полосы прокрутки — это окно (ROLE_SYSTEM_WINDOW), которое окружает элемент управления и имеет то же свойство Name и имя класса окна.
get_accRole — свойство Role зависит от запрашиваемой части полосы прокрутки. Части полосы прокрутки имеют следующие роли.
Часть Роль Сама полоса прокрутки ROLE_SYSTEM_SCROLLBAR Верхняя, стрелка вниз, стрелка влево и стрелка вправо ROLE_SYSTEM_PUSHBUTTON Прокрутка большого пальца ROLE_SYSTEM_INDICATOR Области page up, page down, page left и page right ROLE_SYSTEM_PUSHBUTTON get_accState — свойство State каждого компонента полосы прокрутки включает сочетание следующих значений.
Состояние Значение STATE_SYSTEM_INVISIBLE Для самой полосы прокрутки это означает, что указанная вертикальная или горизонтальная полоса прокрутки не существует. Для областей страницы вверх или вниз это означает, что большой палец расположен так, что область не существует. STATE_SYSTEM_OFFSCREEN Для самой полосы прокрутки это означает, что размер окна такой, что указанная вертикальная или горизонтальная полоса прокрутки в настоящее время не отображается. STATE_SYSTEM_PRESSED Нажата кнопка со стрелкой или область страницы. STATE_SYSTEM_UNAVAILABLE Компонент отключен. get_accValue — свойство Value для окна полосы прокрутки указывает положение полосы прокрутки и представляет собой строку, содержащую целое число от "0" до "100".
Связанные темы