Константы состояния объекта
В этом разделе описываются значения констант, используемые для описания состояния объектов в пользовательском интерфейсе приложения. Константы состояния определяются в файле oleacc.h.
Объект в любое время связан с одним или несколькими из этих значений состояния. Не используются следующие константы состояния объекта: STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW и STATE_SYSTEM_FLOATING.
Клиенты получают состояние объекта, вызывая метод IAccess::get_accState, который возвращает целое число, представляющее собой сочетание следующих битовых флагов. Клиенты вызывают GetStateText со значением состояния, чтобы получить локализованную строку, описывающую состояние объекта.
При изменении состояния объекта серверы должны вызывать NotifyWinEvent с константой события EVENT_OBJECT_STATECHANGE . Однако объекты с константами состояния объекта STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED и STATE_SYSTEM_ SELECTED имеют собственные константы событий. Для этих объектов не используйте EVENT_OBJECT_STATECHANGE. Вместо этого используйте константу отдельного события.
Ниже приведены константы состояния объекта:
| Константа | Описание |
|---|---|
|
(Эта константа состояния объекта не поддерживается.) Указывает важную информацию, которую необходимо немедленно передать пользователю. Например, когда батарея достигает критически низкого уровня, индикатор уровня создает оповещение высокого уровня. В результате средство слепого доступа немедленно объявляет эти сведения пользователю, а программа увеличения экрана прокручивает экран таким образом, чтобы индикатор батареи был на виду. Данное состояние также подходит для любого запроса или операции, которые необходимо завершить перед продолжением работы. |
|
(Эта константа состояния объекта не поддерживается.) Указывает важную информацию, которая не передается пользователю сразу. Например, когда батарея начинает достигать низкого уровня, индикатор уровня создает оповещение среднего уровня. Затем средство слепого доступа создает звук, чтобы сообщить пользователю, что важная информация доступна, не прерывая работу пользователя. Затем пользователь может запрашивать сведения об оповещении, когда это удобно. |
|
(Эта константа состояния объекта не поддерживается.) Указывает сведения с низким приоритетом, которые не важны для пользователя. Это состояние используется, например, когда Word изменяет внешний вид кнопки TipWizard на панели инструментов, чтобы указать, что у нее есть подсказка для пользователя. |
|
Внешний вид объекта меняется быстро или постоянно. Иногда анимированные рисунки описываются как ROLE_SYSTEM_GRAPHIC со свойством State, равным STATE_SYSTEM_ANIMATED. Это состояние используется, чтобы указать, что расположение объекта меняется. |
|
В настоящее время элемент управления не может принимать входные данные. |
|
Выбрано поле проверка объекта. |
|
Дочерние элементы объекта с ROLE_SYSTEM_OUTLINEITEM ролью скрыты. |
|
Это состояние представляет кнопку по умолчанию в окне. |
|
Отображаются дочерние элементы объекта с ролью ROLE_SYSTEM_OUTLINEITEM . |
|
Указывает, что объект расширяет свой выбор с помощью SELFLAG_EXTENDSELECTION в методе IAccessible::accSelect. |
|
(Эта константа состояния объекта не поддерживается.) Объект не обрезается к границе родительского объекта и не перемещается автоматически при перемещении родительского объекта. |
|
Объект находится в активном окне и готов к получению фокуса с клавиатуры. |
|
Объект имеет фокус клавиатуры. Не путайте фокус объекта с выделением объектов. Дополнительные сведения см. в разделе Свойства и методы выделения и фокуса. Для объектов с этим состоянием объекта отправьте EVENT_OBJECT_SHOW или EVENT_OBJECT_HIDE WinEvents, чтобы уведомить клиентские приложения об изменениях состояния. Не используйте EVENT_OBJECT_STATECHANGE. |
|
При вызове объект отображает всплывающее меню или окно. |
|
Объект активно отслеживается мышью, что означает, что внешний вид объекта изменился, чтобы указать, что над ним расположен указатель мыши. |
|
Объект скрыт программным способом. Например, itmes меню программно скрываются до тех пор, пока пользователь не активирует меню. Поскольку объекты с таким состоянием недоступны пользователям, клиентские приложения не должны передавать сведения об объекте пользователям. Однако если клиентские приложения находят объект с таким состоянием, они должны проверка, задана ли STATE_SYSTEM_OFFSCREEN. Если это второе состояние определено, клиенты могут передавать сведения об объекте пользователям. Например, список может иметь как STATE_SYSTEM_INVISIBLE, так и STATE_SYSTEM_OFFSCREEN. В этом случае клиентское приложение может передавать пользователям все элементы в списке. Если клиентское приложение перемещается по дереву IAccessible и обнаруживает невидимый родительский объект, Microsoft Active Accessibility не будет предоставлять сведения о возможных дочерних элементах родительского элемента, пока родительский объект невидим. |
|
Указывает, что объект имеет формат гиперссылки. Роль объекта обычно будет ROLE_SYSTEM_TEXT. |
|
Указывает на прокрутку или перемещение текста или графики. |
|
Указывает, что состояние трех состояний проверка поля или кнопки панели инструментов не определено. Поле проверка не выбирается и не очищается и поэтому находится в третьем или смешанном состоянии. |
|
Указывает, что объект можно переместить. Например, пользователь может щелкнуть строку заголовка объекта и перетащить объект в новое место. |
|
Указывает, что объект принимает несколько выбранных элементов; то есть допустимо SELFLAG_ADDSELECTION для метода IAccessible::accSelect . |
|
Указывает, что объекту не назначено другое состояние. |
|
Объект обрезается или прокручивается, но не скрывается программным способом. Если пользователь увеличит окно просмотра, на экране компьютера будет отображаться больше объектов. |
|
Объект нажат. |
|
Объект является защищенным паролем элементом управления редактирования. |
|
Объект предназначен только для чтения. |
|
Объект принимает выбор. |
|
Объект выбран. |
|
Объект или дочерний объект использует технологию преобразования текста в речь (TTS) в целях описания. Когда объект с таким состоянием имеет фокус, средство поддержки специальных возможностей на основе речи не озвучивает информацию, так как объект автоматически объявляет ее. |
|
Размер объекта можно изменить. Например, пользователь может изменить размер окна, перетащив его за границу. |
|
Объект — это гиперссылка, которую пользователь посетил (щелкнул ранее). |
|
Объект недоступен. |
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|