Класс MenuComponent.AccessibleAWTMenuComponent

java.lang.Object

javax.accessibility.AccessibleContext

java.awt.MenuComponent.AccessibleAWTMenuComponent

Все реализованные интерфейсы:: Serializable, AccessibleComponent, AccessibleSelection

Непосредственные известные подклассы:: MenuBar.AccessibleAWTMenuBar, MenuItem.AccessibleAWTMenuItem

Вложенный класс:: MenuComponent

protected abstract class MenuComponent.AccessibleAWTMenuComponent extends AccessibleContext implements Serializable, AccessibleComponent, AccessibleSelection

Внутренний класс MenuComponent, используемый для предоставления стандартной поддержки доступности. Этот класс не предназначен для прямого использования разработчиками приложений, но предназначен только для наследования разработчиками компонентов меню.

Класс, используемый для получения роли доступности для этого объекта.

С:

1.3

См. также:

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

Поля, объявленные в классе javax.accessibility.AccessibleContext

ACCESSIBLE_ACTION_PROPERTY, ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY, ACCESSIBLE_CARET_PROPERTY, ACCESSIBLE_CHILD_PROPERTY, ACCESSIBLE_COMPONENT_BOUNDS_CHANGED, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_HYPERTEXT_OFFSET, ACCESSIBLE_INVALIDATE_CHILDREN, ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_TABLE_CAPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED, ACCESSIBLE_TABLE_MODEL_CHANGED, ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_ROW_HEADER_CHANGED, ACCESSIBLE_TABLE_SUMMARY_CHANGED, ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY, accessibleDescription, accessibleName, accessibleParent

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

AccessibleAWTMenuComponent()

Модификатор	Конструктор	Описание
`protected`	Хотя класс является абстрактным, его должен вызывать каждый подкласс.

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

Модификатор и тип	Метод	Описание
`void`	`addAccessibleSelection(int i)`	Добавляет указанное `Accessible` дочернее элемент в выделение объекта.
`void`	`addFocusListener(FocusListener l)`	Добавляет указанный обработчик фокуса для получения событий фокуса от этого компонента.
`void`	`clearAccessibleSelection()`	Очищает выделение в объекте, так что ни один из дочерних элементов в объекте не выделен.
`boolean`	`contains(Point p)`	Проверяет, находится ли указанная точка внутри границ этого объекта, где координаты x и y точки определяются как относительные к системе координат объекта.
`Accessible`	`getAccessibleAt(Point p)`	Возвращает `Accessible` дочерний элемент, если он существует, содержащийся в локальных координатах `Point`.
`Accessible`	`getAccessibleChild(int i)`	Возвращает n-ый `Accessible` дочерний элемент объекта.
`int`	`getAccessibleChildrenCount()`	Возвращает количество доступных дочерних элементов в объекте.
`AccessibleComponent`	`getAccessibleComponent()`	Получает связанное с этим объектом `AccessibleComponent`, если оно существует.
`String`	`getAccessibleDescription()`	Получает описание доступности этого объекта.
`int`	`getAccessibleIndexInParent()`	Получает индекс этого объекта в его доступном родительском элементе.
`String`	`getAccessibleName()`	Получает имя доступности этого объекта.
`Accessible`	`getAccessibleParent()`	Получает `Accessible` родительский элемент этого объекта.
`AccessibleRole`	`getAccessibleRole()`	Получает роль этого объекта.
`AccessibleSelection`	`getAccessibleSelection()`	Получает связанное с этим объектом `AccessibleSelection`, которое позволяет выделять его `Accessible` дочерние элементы.
`Accessible`	`getAccessibleSelection(int i)`	Возвращает `Accessible`, представляющий указанный выделенный дочерний элемент в объекте.
`int`	`getAccessibleSelectionCount()`	Возвращает количество `Accessible` дочерних элементов, которые в данный момент выделены.
`AccessibleStateSet`	`getAccessibleStateSet()`	Получает состояние этого объекта.
`Color`	`getBackground()`	Получает цвет фона этого объекта.
`Rectangle`	`getBounds()`	Получает границы этого объекта в виде объекта `Rectangle`.
`Cursor`	`getCursor()`	Получает `Cursor` этого объекта.
`Font`	`getFont()`	Получает `Font` этого объекта.
`FontMetrics`	`getFontMetrics(Font f)`	Получает `FontMetrics` этого объекта.
`Color`	`getForeground()`	Получает цвет переднего плана этого объекта.
`Locale`	`getLocale()`	Возвращает локаль этого объекта.
`Point`	`getLocation()`	Получает расположение объекта относительно родителя в виде точки, задающей верхний левый угол объекта в пространстве координат экрана.
`Point`	`getLocationOnScreen()`	Возвращает расположение объекта на экране.
`Dimension`	`getSize()`	Возвращает размер этого объекта в виде объекта `Dimension`.
`boolean`	`isAccessibleChildSelected(int i)`	Определяет, выделен ли текущий дочерний элемент этого объекта.
`boolean`	`isEnabled()`	Определяет, является ли объект включенным.
`boolean`	`isFocusTraversable()`	Возвращает, может ли этот объект принять фокус или нет.
`boolean`	`isShowing()`	Определяет, отображается ли объект.
`boolean`	`isVisible()`	Определяет, виден ли объект.
`void`	`removeAccessibleSelection(int i)`	Удаляет указанный дочерний элемент объекта из выделения объекта.
`void`	`removeFocusListener(FocusListener l)`	Удаляет указанный обработчик фокуса, чтобы он больше не получал события фокуса от этого компонента.
`void`	`requestFocus()`	Запрашивает фокус для этого объекта.
`void`	`selectAllAccessibleSelection()`	Вызывает выделение каждого дочернего элемента объекта, если объект поддерживает несколько выделений.
`void`	`setBackground(Color c)`	Устанавливает цвет фона этого объекта.
`void`	`setBounds(Rectangle r)`	Устанавливает границы этого объекта в виде объекта `Rectangle`.
`void`	`setCursor(Cursor cursor)`	Устанавливает `Cursor` этого объекта.
`void`	`setEnabled(boolean b)`	Устанавливает состояние включения/выключения объекта.
`void`	`setFont(Font f)`	Устанавливает `Font` этого объекта.
`void`	`setForeground(Color c)`	Устанавливает цвет переднего плана этого объекта.
`void`	`setLocation(Point p)`	Устанавливает расположение объекта относительно родителя.
`void`	`setSize(Dimension d)`	Изменяет размер этого объекта.
`void`	`setVisible(boolean b)`	Устанавливает состояние видимости объекта.

Методы, объявленные в классе javax.accessibility.AccessibleContext

addPropertyChangeListener, firePropertyChange, getAccessibleAction, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleTable, getAccessibleText, getAccessibleValue, removePropertyChangeListener, setAccessibleDescription, setAccessibleName, setAccessibleParent

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

AccessibleAWTMenuComponent

protected AccessibleAWTMenuComponent()

Хотя класс является абстрактным, его должны вызывать все подклассы.

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

getAccessibleSelection

public AccessibleSelection getAccessibleSelection()

Получает AccessibleSelection, связанную с этим объектом, что позволяет выбирать его Accessible дочерние элементы.

Переопределяет:

getAccessibleSelection в классе AccessibleContext

Возвращает:

AccessibleSelection, если поддерживается объектом; в противном случае возвращает null

См. также:

getAccessibleName

public String getAccessibleName()

Получает доступное имя этого объекта. Это почти никогда не должно возвращать java.awt.MenuComponent.getName, так как это обычно не локальное имя и не имеет смысла для пользователя. Если объект по своей сути является текстовым объектом (например, пунктом меню), доступное имя должно быть текстом объекта (например, «сохранить»). Если у объекта есть всплывающая подсказка, текст всплывающей подсказки также может быть подходящей строкой для возврата.

Переопределяет:

getAccessibleName в классе AccessibleContext

Возвращает:

локальное имя объекта — может быть null, если у этого объекта нет имени

См. также:

getAccessibleDescription

public String getAccessibleDescription()

Получает доступное описание этого объекта. Это должно быть краткое, локальное описание того, что представляет собой этот объект — его значение для пользователя. Если у объекта есть всплывающая подсказка, текст всплывающей подсказки может быть подходящей строкой для возврата, предполагая, что она содержит краткое описание объекта (а не только имя объекта — например, значок «Сохранить» на панели инструментов, у которого была подсказка «сохранить», не должен возвращать текст подсказки в качестве описания, а что-то вроде «Сохранить текущий текстовый документ» вместо этого).

Переопределяет:

getAccessibleDescription в классе AccessibleContext

Возвращает:

локальное описание объекта — может быть null, если у этого объекта нет описания

См. также:

getAccessibleRole

public AccessibleRole getAccessibleRole()

Получает роль этого объекта.

Определено в:

getAccessibleRole в классе AccessibleContext

Возвращает:

экземпляр AccessibleRole, описывающий роль объекта

См. также:

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()

Получает состояние этого объекта.

Определено в:

getAccessibleStateSet в классе AccessibleContext

Возвращает:

экземпляр AccessibleStateSet, содержащий текущий набор состояний объекта

См. также:

getAccessibleParent

public Accessible getAccessibleParent()

Получает Accessible родительского объекта. Если родитель этого объекта реализует Accessible, этот метод должен просто вернуть getParent.

Переопределяет:: getAccessibleParent в классе AccessibleContext
Возвращает:: Accessible родитель этого объекта — может быть null, если у этого объекта нет Accessible родителя

getAccessibleIndexInParent

public int getAccessibleIndexInParent()

Получает индекс этого объекта в его доступном родителе.

Определено в:

getAccessibleIndexInParent в классе AccessibleContext

Возвращает:

индекс этого объекта в его родителе; -1, если у этого объекта нет доступного родителя

См. также:

getAccessibleChildrenCount

public int getAccessibleChildrenCount()

Возвращает количество доступных дочерних элементов в объекте. Если все дочерние элементы этого объекта реализуют Accessible, то этот метод должен возвращать количество дочерних элементов этого объекта.

Определено в:: getAccessibleChildrenCount в классе AccessibleContext
Возвращает:: количество доступных дочерних элементов в объекте

getAccessibleChild

public Accessible getAccessibleChild(int i)

Возвращает n-ый Accessible дочерний элемент объекта.

Определено в:

getAccessibleChild в классе AccessibleContext

Параметры:

i — индекс дочернего элемента (от нуля)

Возвращает:

n-ый доступный дочерний элемент объекта

См. также:

getLocale

public Locale getLocale()

Возвращает локаль этого объекта.

Определено в:: getLocale в классе AccessibleContext
Возвращает:: локаль этого объекта

getAccessibleComponent

public AccessibleComponent getAccessibleComponent()

Получает AccessibleComponent, связанный с этим объектом, если он существует. В противном случае вернуть null.

Переопределяет:

getAccessibleComponent в классе AccessibleContext

Возвращает:

компонент

См. также:

getBackground

public Color getBackground()

Получает цвет фона этого объекта.

Определено в:

getBackground в интерфейсе AccessibleComponent

Возвращает:

цвет фона, если поддерживается, объекта; в противном случае null

См. также:

setBackground

public void setBackground(Color c)

Устанавливает цвет фона этого объекта. (Для прозрачности см. isOpaque.)

Определено в:

setBackground в интерфейсе AccessibleComponent

Параметры:

c — новый Color для фона

См. также:

getForeground

public Color getForeground()

Получает цвет переднего плана этого объекта.

Определено в:

getForeground в интерфейсе AccessibleComponent

Возвращает:

цвет переднего плана, если поддерживается, объекта; в противном случае null

См. также:

setForeground

public void setForeground(Color c)

Устанавливает цвет переднего плана этого объекта.

Определено в:

setForeground в интерфейсе AccessibleComponent

Параметры:

c — новый Color для переднего плана

См. также:

getCursor

public Cursor getCursor()

Получает Cursor этого объекта.

Определено в:

getCursor в интерфейсе AccessibleComponent

Возвращает:

Cursor, если поддерживается, объекта; в противном случае null

См. также:

END_OF_DOCUMENT_MARKER

setCursor

public void setCursor(Cursor cursor)

Устанавливает Cursor этого объекта.

Метод может не иметь визуального эффекта, если реализация платформы Java и/или родная система не поддерживают изменение формы указателя мыши.

Specified by:

setCursor в интерфейсе AccessibleComponent

Parameters:

cursor - новый Cursor для объекта

See Also:

getFont

public Font getFont()

Получает Font этого объекта.

Specified by:

getFont в интерфейсе AccessibleComponent

Returns:

шрифт Font, если поддерживается; в противном случае, null

See Also:

setFont

public void setFont(Font f)

Устанавливает Font этого объекта.

Specified by:

setFont в интерфейсе AccessibleComponent

Parameters:

f - новый Font для объекта

See Also:

getFontMetrics

public FontMetrics getFontMetrics(Font f)

Получает FontMetrics этого объекта.

Specified by:

getFontMetrics в интерфейсе AccessibleComponent

Parameters:

f - шрифт Font

Returns:

FontMetrics, если поддерживается, для объекта; в противном случае, null

See Also:

isEnabled

public boolean isEnabled()

Определяет, включён ли объект.

Specified by:

isEnabled в интерфейсе AccessibleComponent

Returns:

true, если объект включён; иначе, false

See Also:

setEnabled

public void setEnabled(boolean b)

Устанавливает состояние включения объекта.

Specified by:

setEnabled в интерфейсе AccessibleComponent

Parameters:

b - true для включения объекта, иначе - для отключения

See Also:

isVisible

public boolean isVisible()

Определяет, виден ли объект. Примечание: это означает, что объект намерен быть видимым; однако, он может на самом деле не отображаться на экране, потому что один из объектов, в котором этот объект содержится, не виден. Чтобы определить, отображается ли объект на экране, используйте isShowing.

Specified by:

isVisible в интерфейсе AccessibleComponent

Returns:

true, если объект виден; иначе, false

See Also:

setVisible

public void setVisible(boolean b)

Устанавливает состояние видимости объекта.

Specified by:

setVisible в интерфейсе AccessibleComponent

Parameters:

b - true для отображения объекта, иначе - для скрытия

See Also:

isShowing

public boolean isShowing()

Определяет, отображается ли объект. Это определяется путем проверки видимости объекта и предков объекта. Примечание: это вернёт true даже если объект закрыт другим (например, он находится под раскрывающимся меню).

Specified by:: isShowing в интерфейсе AccessibleComponent
Returns:: true, если объект отображается; иначе, false

contains

public boolean contains(Point p)

Проверяет, находится ли указанная точка внутри границ этого объекта, где координаты x и y точки определены как относительные к системе координат объекта.

Specified by:

contains в интерфейсе AccessibleComponent

Parameters:

p - Point, относительная к системе координат объекта

Returns:

true, если объект содержит Point; иначе false

See Also:

getLocationOnScreen

public Point getLocationOnScreen()

Возвращает расположение объекта на экране.

Specified by:

getLocationOnScreen в интерфейсе AccessibleComponent

Returns:

местоположение объекта на экране - может быть null, если этот объект не на экране

See Also:

getLocation

public Point getLocation()

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

Specified by:

getLocation в интерфейсе AccessibleComponent

Returns:

экземпляр Point, представляющий верхний левый угол границ объекта в пространстве координат экрана; null, если этот объект или его родитель не находятся на экране

See Also:

setLocation

public void setLocation(Point p)

Устанавливает расположение объекта относительно родителя.

Specified by:

setLocation в интерфейсе AccessibleComponent

Parameters:

p - новое положение для верхнего левого угла

See Also:

getBounds

public Rectangle getBounds()

Получает границы этого объекта в виде объекта Rectangle. Границы задают ширину, высоту и расположение этого объекта относительно его родителя.

Specified by:

getBounds в интерфейсе AccessibleComponent

Returns:

прямоугольник, указывающий границы этого компонента; null, если этот объект не на экране

See Also:

setBounds

public void setBounds(Rectangle r)

Устанавливает границы этого объекта в виде объекта Rectangle. Границы задают ширину, высоту и расположение этого объекта относительно его родителя.

Specified by:

setBounds в интерфейсе AccessibleComponent

Parameters:

r - прямоугольник, указывающий границы этого компонента

See Also:

getSize

public Dimension getSize()

Возвращает размер этого объекта в виде объекта Dimension. Поле height объекта Dimension содержит высоту этого объекта, а поле width объекта Dimension содержит ширину этого объекта.

Определено в:

getSize в интерфейсе AccessibleComponent

Возвращает:

объект Dimension, указывающий размер этого компонента; null, если этот объект не отображается на экране

См. также:

setSize

public void setSize(Dimension d)

Изменяет размер этого объекта.

Определено в:

setSize в интерфейсе AccessibleComponent

Параметры:

d - Dimension, определяющий новый размер объекта

См. также:

getAccessibleAt

public Accessible getAccessibleAt(Point p)

Возвращает дочерний элемент Accessible, если он существует, расположенный по локальным координатам Point. Если дочерний элемент Accessible отсутствует, возвращается null.

Определено в:: getAccessibleAt в интерфейсе AccessibleComponent
Параметры:: p - точка, определяющая верхний левый угол Accessible, заданная в системе координат родительского объекта
Возвращает:: элемент Accessible, если он существует в указанном месте; иначе null

isFocusTraversable

public boolean isFocusTraversable()

Возвращает, может ли этот объект получить фокус или нет.

Определено в:

isFocusTraversable в интерфейсе AccessibleComponent

Возвращает:

true, если объект может получить фокус; в противном случае false

См. также:

requestFocus

public void requestFocus()

Запрашивает фокус для этого объекта.

Определено в:

requestFocus в интерфейсе AccessibleComponent

См. также:

addFocusListener

public void addFocusListener(FocusListener l)

Добавляет указанного слушателя фокуса для получения событий фокуса от этого компонента.

Определено в:

addFocusListener в интерфейсе AccessibleComponent

Параметры:

l - слушатель фокуса

См. также:

removeFocusListener

public void removeFocusListener(FocusListener l)

Удаляет указанного слушателя фокуса, чтобы он больше не получал события фокуса от этого компонента.

Определено в:

removeFocusListener в интерфейсе AccessibleComponent

Параметры:

l - слушатель фокуса

См. также:

getAccessibleSelectionCount

public int getAccessibleSelectionCount()

Возвращает количество Accessible дочерних элементов, которые в данный момент выбраны. Если дочерние элементы не выбраны, возвращается 0.

Определено в:: getAccessibleSelectionCount в интерфейсе AccessibleSelection
Возвращает:: количество выбранных элементов

getAccessibleSelection

public Accessible getAccessibleSelection(int i)

Возвращает Accessible, представляющий i-й выбранный дочерний элемент в объекте. Если выбор отсутствует или выбранных дочерних элементов меньше, чем переданное целое число, возвращается null.

Обратите внимание, что индекс представляет i-й выбранный дочерний элемент, что отличается от i-го дочернего элемента.

Определено в:

getAccessibleSelection в интерфейсе AccessibleSelection

Параметры:

i - нулевой индекс выбранных дочерних элементов

Возвращает:

i-й выбранный дочерний элемент

См. также:

isAccessibleChildSelected

public boolean isAccessibleChildSelected(int i)

Определяет, выбран ли текущий дочерний элемент этого объекта.

Определено в:

isAccessibleChildSelected в интерфейсе AccessibleSelection

Параметры:

i - нулевой индекс дочернего элемента в этом объекте Accessible

Возвращает:

true, если текущий дочерний элемент этого объекта выбран; в противном случае false

См. также:

addAccessibleSelection

public void addAccessibleSelection(int i)

Добавляет указанный Accessible дочерний элемент объекта к выбору объекта. Если объект поддерживает множественный выбор, указанный дочерний элемент добавляется к любому существующему выбору; в противном случае он заменяет любой существующий выбор в объекте. Если указанный дочерний элемент уже выбран, этот метод не оказывает влияния.

Определено в:

addAccessibleSelection в интерфейсе AccessibleSelection

Параметры:

i - нулевой индекс дочернего элемента

См. также:

removeAccessibleSelection

public void removeAccessibleSelection(int i)

Удаляет указанный дочерний элемент объекта из выбора объекта. Если указанный элемент не выбран, этот метод не оказывает влияния.

Определено в:

removeAccessibleSelection в интерфейсе AccessibleSelection

Параметры:

i - нулевой индекс дочернего элемента

См. также:

clearAccessibleSelection

public void clearAccessibleSelection()

Очищает выбор в объекте, так что ни один дочерний элемент в объекте не выбран.

Определено в:: clearAccessibleSelection в интерфейсе AccessibleSelection

selectAllAccessibleSelection

public void selectAllAccessibleSelection()

Выбирает все дочерние элементы объекта, если объект поддерживает множественный выбор.

Определено в:: selectAllAccessibleSelection в интерфейсе AccessibleSelection

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/MenuComponent.AccessibleAWTMenuComponent.html