Spec-Zone.ru › OpenJDK 27

Класс AccessibleState

java.lang.Object
javax.accessibility.AccessibleBundle
javax.accessibility.AccessibleState
public class AccessibleState extends AccessibleBundle
Класс AccessibleState описывает конкретное состояние компонента. Фактическое состояние компонента определяется как AccessibleStateSet — составной набор из AccessibleStates.

Метод AccessibleBundle.toDisplayString() позволяет получить локализованную строку для независимого от локали ключа из предопределённого ResourceBundle для ключей, определённых в этом классе.

Константы этого класса представляют собой строго типизированное перечисление распространённых ролей объектов. Публичный конструктор этого класса намеренно не предоставлен; приложениям следует использовать одну из констант этого класса. Если констант этого класса недостаточно для описания роли объекта, следует создать подкласс этого класса и предоставить в нём константы аналогичным образом.

Краткое описание полей

Модификатор и тип Поле Описание
static final AccessibleState ACTIVE
Указывает, что окно в данный момент является активным.
static final AccessibleState ARMED
Указывает, что объект взведён.
static final AccessibleState BUSY
Указывает, что текущий объект занят.
static final AccessibleState CHECKED
Указывает, что этот объект отмечен.
static final AccessibleState COLLAPSED
Указывает, что этот объект свёрнут.
static final AccessibleState EDITABLE
Указывает, что пользователь может изменить содержимое этого объекта.
static final AccessibleState ENABLED
Указывает, что этот объект включён.
static final AccessibleState EXPANDABLE
Указывает, что этот объект позволяет постепенно раскрывать дочерние элементы.
static final AccessibleState EXPANDED
Указывает, что этот объект развёрнут.
static final AccessibleState FOCUSABLE
Указывает, что этот объект может получать фокус клавиатуры, то есть все события, возникающие при вводе с клавиатуры, обычно передаются ему, когда он находится в фокусе.
static final AccessibleState FOCUSED
Указывает, что этот объект в данный момент находится в фокусе клавиатуры.
static final AccessibleState HORIZONTAL
Указывает, что ориентация этого объекта горизонтальная.
static final AccessibleState ICONIFIED
Указывает, что этот объект свёрнут и представлен только значком.
static final AccessibleState INDETERMINATE
Указывает, что состояние объекта неопределённо.
static final AccessibleState MANAGES_DESCENDANTS
Указывает, что этот объект отвечает за управление своими подкомпонентами.
static final AccessibleState MODAL
Указывает, что с этим объектом необходимо выполнить какое-либо действие, прежде чем пользователь сможет взаимодействовать с объектом в другом окне.
static final AccessibleState MULTI_LINE
Указывает, что этот (текстовый) объект может содержать несколько строк текста.
static final AccessibleState MULTISELECTABLE
Указывает, что этот объект позволяет одновременно выбирать несколько дочерних элементов.
static final AccessibleState OPAQUE
Указывает, что этот объект закрашивает каждый пиксель в пределах своей прямоугольной области.
static final AccessibleState PRESSED
Указывает, что на этот объект в данный момент нажато.
static final AccessibleState RESIZABLE
Указывает, что размер этого объекта не фиксирован.
static final AccessibleState SELECTABLE
Указывает, что этот объект является дочерним элементом объекта, допускающего выбор своих дочерних элементов, и что этот дочерний элемент можно выбрать.
static final AccessibleState SELECTED
Указывает, что этот объект является дочерним элементом объекта, допускающего выбор своих дочерних элементов, и что этот дочерний элемент выбран.
static final AccessibleState SHOWING
Указывает, что этот объект, его родительский объект, родительский объект его родителя и так далее видимы.
static final AccessibleState SINGLE_LINE
Указывает, что этот (текстовый) объект может содержать только одну строку текста.
static final AccessibleState TRANSIENT
Указывает, что этот объект является временным.
static final AccessibleState TRUNCATED
Состояние, указывающее, что текст обрезан ограничивающим прямоугольником и часть текста не отображается на экране.
static final AccessibleState VERTICAL
Указывает, что ориентация этого объекта вертикальная.
static final AccessibleState VISIBLE
Указывает, что этот объект видим.

Поля, объявленные в классе AccessibleBundle

key
Модификатор и тип Поле Описание
protected String key
Имя состояния, независимое от локали.

Краткое описание конструкторов

AccessibleState(String key)
Модификатор Конструктор Описание
protected
Создаёт новый AccessibleState с использованием заданного ключа, независимого от локали.

Краткое описание методов

Методы, объявленные в классе AccessibleBundle

toDisplayString, toDisplayString, toDisplayString, toString
Модификатор и тип Метод Описание
String toDisplayString()
Возвращает локализованную строку с описанием ключа, используя локаль по умолчанию.
protected String toDisplayString(String name, Locale locale)
Возвращает ключ в виде локализованной строки.
String toDisplayString(Locale locale)
Возвращает ключ в виде локализованной строки.
String toString()
Возвращает локализованную строку с описанием ключа, используя локаль по умолчанию.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создаёт и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли какой-либо другой объект этому объекту.
protected void finalize()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечёт заданный промежуток реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечёт заданный промежуток реального времени.

Подробное описание полей

ACTIVE

public static final AccessibleState ACTIVE
Указывает, что окно в данный момент является активным. Это относится к окнам, диалоговым окнам, фреймам и т. д. Кроме того, это состояние используется для обозначения текущего активного дочернего элемента такого компонента, как список, таблица или дерево. Например, активный дочерний элемент списка — это элемент, вокруг которого отображается прямоугольная рамка.
См. также:
  • AccessibleRole.WINDOW
  • AccessibleRole.FRAME
  • AccessibleRole.DIALOG

PRESSED

public static final AccessibleState PRESSED
Указывает, что на этот объект в данный момент нажато. Обычно это состояние связано с кнопками и означает, что пользователь нажал кнопку мыши, когда указатель находился над кнопкой, но ещё не отпустил её.
См. также:
  • AccessibleRole.PUSH_BUTTON

ARMED

public static final AccessibleState ARMED
Указывает, что объект взведён. Обычно это состояние используется для кнопок, которые были нажаты, но ещё не отпущены, когда указатель мыши всё ещё находится над кнопкой.
См. также:
  • AccessibleRole.PUSH_BUTTON

BUSY

public static final AccessibleState BUSY
Указывает, что текущий объект занят. Обычно это состояние используется для таких объектов, как индикаторы выполнения, ползунки или полосы прокрутки, чтобы указать, что они находятся в переходном состоянии.
См. также:
  • AccessibleRole.PROGRESS_BAR
  • AccessibleRole.SCROLL_BAR
  • AccessibleRole.SLIDER

CHECKED

public static final AccessibleState CHECKED
Указывает, что этот объект отмечен. Обычно это состояние используется для таких объектов, как переключатели, радиокнопки и флажки.
См. также:
  • AccessibleRole.TOGGLE_BUTTON
  • AccessibleRole.RADIO_BUTTON
  • AccessibleRole.CHECK_BOX

EDITABLE

public static final AccessibleState EDITABLE
Указывает, что пользователь может изменить содержимое этого объекта. Обычно это состояние используется прежде всего для объектов, позволяющих пользователю вводить текст. Другие объекты, например полосы прокрутки и ползунки, автоматически считаются доступными для редактирования, если они включены.
См. также:
  • ENABLED

EXPANDABLE

public static final AccessibleState EXPANDABLE
Указывает, что этот объект позволяет постепенно раскрывать дочерние элементы. Обычно это состояние используется для иерархических объектов, таких как деревья, и часто сочетается с состояниями EXPANDED или COLLAPSED.
См. также:
  • EXPANDED
  • COLLAPSED
  • AccessibleRole.TREE

COLLAPSED

public static final AccessibleState COLLAPSED
Указывает, что этот объект свёрнут. Обычно это состояние сочетается с состоянием EXPANDABLE и используется для объектов, обеспечивающих постепенное раскрытие, например деревьев.
См. также:
  • EXPANDABLE
  • EXPANDED
  • AccessibleRole.TREE

EXPANDED

public static final AccessibleState EXPANDED
Указывает, что этот объект развёрнут. Обычно это состояние сочетается с состоянием EXPANDABLE и используется для объектов, обеспечивающих постепенное раскрытие, например деревьев.
См. также:
  • EXPANDABLE
  • COLLAPSED
  • AccessibleRole.TREE

ENABLED

public static final AccessibleState ENABLED
Указывает, что этот объект включён. Отсутствие этого состояния в наборе состояний объекта означает, что объект отключён. Отключённым объектом пользователь не может управлять. В графическом интерфейсе такой объект обычно отображается серым цветом.

FOCUSABLE

public static final AccessibleState FOCUSABLE
Указывает, что этот объект может получать фокус клавиатуры, то есть все события, возникающие при вводе с клавиатуры, обычно передаются ему, когда он находится в фокусе.
См. также:
  • FOCUSED

FOCUSED

public static final AccessibleState FOCUSED
Указывает, что этот объект в данный момент находится в фокусе клавиатуры.
См. также:
  • FOCUSABLE

ICONIFIED

public static final AccessibleState ICONIFIED
Указывает, что этот объект свёрнут и представлен только значком. Обычно это состояние относится только к фреймам и внутренним фреймам.
См. также:
  • AccessibleRole.FRAME
  • AccessibleRole.INTERNAL_FRAME

MODAL

public static final AccessibleState MODAL
Указывает, что с этим объектом необходимо выполнить какое-либо действие, прежде чем пользователь сможет взаимодействовать с объектом в другом окне. Обычно это состояние относится только к диалоговым окнам.
См. также:
  • AccessibleRole.DIALOG

OPAQUE

public static final AccessibleState OPAQUE
Указывает, что этот объект закрашивает каждый пиксель в пределах своей прямоугольной области. Непрозрачный не полностью компонент закрашивает только часть своих пикселей, позволяя пикселям под ним «просвечивать». Следовательно, компонент, который закрашивает не все свои пиксели, обладает некоторой степенью прозрачности.
См. также:
  • Accessible.getAccessibleContext()
  • AccessibleContext.getAccessibleComponent()
  • AccessibleComponent.getBounds()

RESIZABLE

public static final AccessibleState RESIZABLE
Указывает, что размер этого объекта не фиксирован.
См. также:
  • Accessible.getAccessibleContext()
  • AccessibleContext.getAccessibleComponent()
  • AccessibleComponent.getSize()
  • AccessibleComponent.setSize(Dimension)

MULTISELECTABLE

public static final AccessibleState MULTISELECTABLE
Указывает, что этот объект позволяет одновременно выбирать несколько дочерних элементов.
См. также:
  • Accessible.getAccessibleContext()
  • AccessibleContext.getAccessibleSelection()
  • AccessibleSelection

SELECTABLE

public static final AccessibleState SELECTABLE
Указывает, что этот объект является дочерним элементом объекта, допускающего выбор своих дочерних элементов, и что этот дочерний элемент можно выбрать.
См. также:
  • SELECTED
  • Accessible.getAccessibleContext()
  • AccessibleContext.getAccessibleSelection()
  • AccessibleSelection

SELECTED

public static final AccessibleState SELECTED
Указывает, что этот объект является дочерним элементом объекта, допускающего выбор своих дочерних элементов, и что этот дочерний элемент выбран.
См. также:
  • SELECTABLE
  • Accessible.getAccessibleContext()
  • AccessibleContext.getAccessibleSelection()
  • AccessibleSelection

SHOWING

public static final AccessibleState SHOWING
Указывает, что этот объект, его родительский объект, родительский объект его родителя и так далее видимы. Обратите внимание: это не обязательно означает, что объект отображается на экране. Он может быть закрыт другим отображаемым объектом.
См. также:
  • VISIBLE

VISIBLE

public static final AccessibleState VISIBLE
Указывает, что этот объект видим. Примечание: это означает, что объект должен быть видимым; однако фактически он может не отображаться на экране, поскольку один из объектов, содержащих его, невидим.
См. также:
  • SHOWING

VERTICAL

public static final AccessibleState VERTICAL
Указывает, что ориентация этого объекта вертикальная. Обычно это состояние относится к таким объектам, как полосы прокрутки, ползунки и индикаторы выполнения.
См. также:
  • HORIZONTAL
  • AccessibleRole.SCROLL_BAR
  • AccessibleRole.SLIDER
  • AccessibleRole.PROGRESS_BAR

HORIZONTAL

public static final AccessibleState HORIZONTAL
Указывает, что ориентация этого объекта горизонтальная. Обычно это состояние относится к таким объектам, как полосы прокрутки, ползунки и индикаторы выполнения.
См. также:
  • VERTICAL
  • AccessibleRole.SCROLL_BAR
  • AccessibleRole.SLIDER
  • AccessibleRole.PROGRESS_BAR

SINGLE_LINE

public static final AccessibleState SINGLE_LINE
Указывает, что этот (текстовый) объект может содержать только одну строку текста.

MULTI_LINE

public static final AccessibleState MULTI_LINE
Указывает, что этот (текстовый) объект может содержать несколько строк текста.

TRANSIENT

public static final AccessibleState TRANSIENT
Указывает, что этот объект является временным. Вспомогательная технология не должна добавлять слушатель PropertyChange к объекту с временным состоянием, поскольку такой объект никогда не будет генерировать события. Временные объекты обычно создаются для обработки запросов методов Java Accessibility, но в остальном не остаются связанными с базовым объектом (например, объекты, расположенные под списками, таблицами и деревьями Swing, где только один реальный UI Component выполняет общую отрисовку для всех объектов данных под элементами списка/таблицы/дерева).
Начиная с:
1.5

MANAGES_DESCENDANTS

public static final AccessibleState MANAGES_DESCENDANTS
Указывает, что этот объект отвечает за управление своими подкомпонентами. Обычно это состояние используется для деревьев и таблиц с большим количеством подкомпонентов, объекты которых создаются только по мере необходимости, а в остальное время остаются виртуальными. Приложение не должно управлять подкомпонентами напрямую.
Начиная с:
1.5

INDETERMINATE

public static final AccessibleState INDETERMINATE
Указывает, что состояние объекта неопределённо. Например, выделенный текст может быть частично полужирным, а частично обычным. В этом случае атрибуты выделенного текста неопределённы.
Начиная с:
1.5

TRUNCATED

public static final AccessibleState TRUNCATED
Состояние, указывающее, что текст обрезан ограничивающим прямоугольником и часть текста не отображается на экране. Например, текст в ячейке электронной таблицы может быть обрезан границами ячейки.
Начиная с:
1.5

Подробное описание конструкторов

AccessibleState

protected AccessibleState(String key)
Создаёт новый AccessibleState с использованием заданного ключа, независимого от локали. Этот метод не должен быть публичным. Вместо этого он используется для создания констант в этом файле, чтобы обеспечить строго типизированное перечисление. Подклассы этого класса должны придерживаться аналогичной политики.

Ключ String должен быть ключом состояния, независимым от локали. Он не предназначен для использования в качестве фактического String, отображаемого пользователю. Чтобы получить локализованную строку, используйте AccessibleBundle.toDisplayString().

Параметры:
key - имя состояния, независимое от локали
См. также:
  • AccessibleBundle.toDisplayString(String, Locale)

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и работающие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2026, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API