Константы состояния объекта

В этом разделе описываются значения констант, используемые для описания состояния объектов в пользовательском интерфейсе приложения. Константы состояния определяются в файле 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. Вместо этого используйте константу отдельного события.

Ниже приведены константы состояния объекта:

Константа	Описание
STATE_SYSTEM_ALERT_HIGH	(Эта константа состояния объекта не поддерживается.) Указывает важную информацию, которую необходимо немедленно передать пользователю. Например, когда батарея достигает критически низкого уровня, индикатор уровня создает оповещение высокого уровня. В результате средство слепого доступа немедленно объявляет эти сведения пользователю, а программа увеличения экрана прокручивает экран таким образом, чтобы индикатор батареи был на виду. Данное состояние также подходит для любого запроса или операции, которые необходимо завершить перед продолжением работы.
STATE_SYSTEM_ALERT_MEDIUM	(Эта константа состояния объекта не поддерживается.) Указывает важную информацию, которая не передается пользователю сразу. Например, когда батарея начинает достигать низкого уровня, индикатор уровня создает оповещение среднего уровня. Затем средство слепого доступа создает звук, чтобы сообщить пользователю, что важная информация доступна, не прерывая работу пользователя. Затем пользователь может запрашивать сведения об оповещении, когда это удобно.
STATE_SYSTEM_ALERT_LOW	(Эта константа состояния объекта не поддерживается.) Указывает сведения с низким приоритетом, которые не важны для пользователя. Это состояние используется, например, когда Word изменяет внешний вид кнопки TipWizard на панели инструментов, чтобы указать, что у нее есть подсказка для пользователя.
STATE_SYSTEM_ANIMATED	Внешний вид объекта меняется быстро или постоянно. Иногда анимированные рисунки описываются как ROLE_SYSTEM_GRAPHIC со свойством State, равным STATE_SYSTEM_ANIMATED. Это состояние используется, чтобы указать, что расположение объекта меняется.
STATE_SYSTEM_BUSY	В настоящее время элемент управления не может принимать входные данные.
STATE_SYSTEM_CHECKED	Выбрано поле проверка объекта.
STATE_SYSTEM_COLLAPSED	Дочерние элементы объекта с ROLE_SYSTEM_OUTLINEITEM ролью скрыты.
STATE_SYSTEM_DEFAULT	Это состояние представляет кнопку по умолчанию в окне.
STATE_SYSTEM_EXPANDED	Отображаются дочерние элементы объекта с ролью ROLE_SYSTEM_OUTLINEITEM .
STATE_SYSTEM_EXTSELECTABLE	Указывает, что объект расширяет свой выбор с помощью SELFLAG_EXTENDSELECTION в методе IAccessible::accSelect.
STATE_SYSTEM_FLOATING	(Эта константа состояния объекта не поддерживается.) Объект не обрезается к границе родительского объекта и не перемещается автоматически при перемещении родительского объекта.
STATE_SYSTEM_FOCUSABLE	Объект находится в активном окне и готов к получению фокуса с клавиатуры.
STATE_SYSTEM_FOCUSED	Объект имеет фокус клавиатуры. Не путайте фокус объекта с выделением объектов. Дополнительные сведения см. в разделе Свойства и методы выделения и фокуса. Для объектов с этим состоянием объекта отправьте EVENT_OBJECT_SHOW или EVENT_OBJECT_HIDE WinEvents, чтобы уведомить клиентские приложения об изменениях состояния. Не используйте EVENT_OBJECT_STATECHANGE.
STATE_SYSTEM_HASPOPUP	При вызове объект отображает всплывающее меню или окно.
STATE_SYSTEM_HOTTRACKED	Объект активно отслеживается мышью, что означает, что внешний вид объекта изменился, чтобы указать, что над ним расположен указатель мыши.
STATE_SYSTEM_INVISIBLE	Объект скрыт программным способом. Например, itmes меню программно скрываются до тех пор, пока пользователь не активирует меню. Поскольку объекты с таким состоянием недоступны пользователям, клиентские приложения не должны передавать сведения об объекте пользователям. Однако если клиентские приложения находят объект с таким состоянием, они должны проверка, задана ли STATE_SYSTEM_OFFSCREEN. Если это второе состояние определено, клиенты могут передавать сведения об объекте пользователям. Например, список может иметь как STATE_SYSTEM_INVISIBLE, так и STATE_SYSTEM_OFFSCREEN. В этом случае клиентское приложение может передавать пользователям все элементы в списке. Если клиентское приложение перемещается по дереву IAccessible и обнаруживает невидимый родительский объект, Microsoft Active Accessibility не будет предоставлять сведения о возможных дочерних элементах родительского элемента, пока родительский объект невидим.
STATE_SYSTEM_LINKED	Указывает, что объект имеет формат гиперссылки. Роль объекта обычно будет ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED	Указывает на прокрутку или перемещение текста или графики.
STATE_SYSTEM_MIXED	Указывает, что состояние трех состояний проверка поля или кнопки панели инструментов не определено. Поле проверка не выбирается и не очищается и поэтому находится в третьем или смешанном состоянии.
STATE_SYSTEM_MOVEABLE	Указывает, что объект можно переместить. Например, пользователь может щелкнуть строку заголовка объекта и перетащить объект в новое место.
STATE_SYSTEM_MULTISELECTABLE	Указывает, что объект принимает несколько выбранных элементов; то есть допустимо SELFLAG_ADDSELECTION для метода IAccessible::accSelect .
STATE_SYSTEM_NORMAL	Указывает, что объекту не назначено другое состояние.
STATE_SYSTEM_OFFSCREEN	Объект обрезается или прокручивается, но не скрывается программным способом. Если пользователь увеличит окно просмотра, на экране компьютера будет отображаться больше объектов.
STATE_SYSTEM_PRESSED	Объект нажат.
STATE_SYSTEM_PROTECTED	Объект является защищенным паролем элементом управления редактирования.
STATE_SYSTEM_READONLY	Объект предназначен только для чтения.
STATE_SYSTEM_SELECTABLE	Объект принимает выбор.
STATE_SYSTEM_SELECTED	Объект выбран.
STATE_SYSTEM_SELFVOICING	Объект или дочерний объект использует технологию преобразования текста в речь (TTS) в целях описания. Когда объект с таким состоянием имеет фокус, средство поддержки специальных возможностей на основе речи не озвучивает информацию, так как объект автоматически объявляет ее.
STATE_SYSTEM_SIZEABLE	Размер объекта можно изменить. Например, пользователь может изменить размер окна, перетащив его за границу.
STATE_SYSTEM_TRAVERSED	Объект — это гиперссылка, которую пользователь посетил (щелкнул ранее).
STATE_SYSTEM_UNAVAILABLE	Объект недоступен.

Требования

Требование	Значение
Заголовок	Oleacc.h