Класс Translator

java.lang.Object

javax.accessibility.AccessibleContext

com.sun.java.accessibility.util.Translator

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

public class Translator extends AccessibleContext implements Accessible, AccessibleComponent

Класс Translator предоставляет перевод к интерфейсу Accessible для объектов, которые не реализуют интерфейс Accessible. Технологии помощи могут использовать метод класса getAccessible класса Translator для получения объекта, реализующего интерфейс Accessible. Если переданный объект уже реализует интерфейс Accessible, getAccessible просто возвращает этот объект.

Пример того, как технология помощи может использовать класс Translator:

    Accessible accessible = Translator.getAccessible(someObj);
    // obtain information from the 'accessible' object.

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

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

Модификатор и тип	Поле	Описание
`protected Object`	`source`	Объект-источник, требующий перевода.

Поля, объявленные в классе 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

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

Конструктор	Описание
`Translator()`	Создаёт новый `Translator`.
`Translator(Object o)`	Создаёт новый `Translator` с объектом-источником o.

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

Модификатор и тип	Метод	Описание
`void`	`addFocusListener(FocusListener l)`	Добавляет указанный `FocusListener` для получения событий фокуса от этого компонента.
`void`	`addPropertyChangeListener(PropertyChangeListener l)`	Добавляет `PropertyChangeListener` в список слушателей.
`boolean`	`contains(Point p)`	Проверяет, находится ли указанный `Point` внутри границ этого объекта, где `Point` относительно системы координат объекта.
`boolean`	`equals(Object o)`	Возвращает true, если этот объект такой же, как переданный.
`static Accessible`	`getAccessible(Object o)`	Получить объект, реализующий интерфейс `Accessible`.
`Accessible`	`getAccessibleAt(Point p)`	Возвращает доступного дочернего элемента, содержащегося в локальной координате Point, если он существует.
`Accessible`	`getAccessibleChild(int i)`	Возвращает n-й доступный дочерний элемент объекта.
`int`	`getAccessibleChildrenCount()`	Возвращает количество доступных дочерних элементов в объекте.
`AccessibleContext`	`getAccessibleContext()`	Возвращает этот объект.
`String`	`getAccessibleDescription()`	Получить описание доступности этого объекта.
`int`	`getAccessibleIndexInParent()`	Получить индекс этого объекта в его родительском объекте доступности.
`String`	`getAccessibleName()`	Получить имя доступности этого объекта.
`Accessible`	`getAccessibleParent()`	Получить родительский объект доступности этого объекта.
`AccessibleRole`	`getAccessibleRole()`	Получить роль этого объекта.
`AccessibleStateSet`	`getAccessibleStateSet()`	Получить состояние этого объекта, учитывая уже заполненное состояние.
`Color`	`getBackground()`	Получить фоновый `Color` этого объекта.
`Rectangle`	`getBounds()`	Возвращает текущие границы этого объекта.
`Cursor`	`getCursor()`	Получить `Cursor` этого объекта.
`Font`	`getFont()`	Получить `Font` этого объекта.
`FontMetrics`	`getFontMetrics(Font f)`	Получить `FontMetrics` этого объекта.
`Color`	`getForeground()`	Получить фоновый `Color` этого объекта.
`Locale`	`getLocale()`	Получает `Locale` компонента.
`Point`	`getLocation()`	Возвращает расположение объекта относительно родителя.
`Point`	`getLocationOnScreen()`	Возвращает расположение объекта на экране.
`Dimension`	`getSize()`	Возвращает текущий размер этого объекта.
`Object`	`getSource()`	Получить объект-источник `Object` `Translator`.
`protected static Class<?>`	`getTranslatorClass(Class<?> c)`	Находит переводчика для этого класса.
`int`	`hashCode()`	Возвращает хэш-код.
`boolean`	`isEnabled()`	Определяет, включен ли объект.
`boolean`	`isFocusTraversable()`	Возвращает, может ли этот объект принять фокус.
`boolean`	`isShowing()`	Определяет, отображается ли объект.
`boolean`	`isVisible()`	Определяет, виден ли объект.
`void`	`removeFocusListener(FocusListener l)`	Удаляет указанного слушателя фокуса, чтобы он больше не получал события фокуса от этого компонента.
`void`	`removePropertyChangeListener(PropertyChangeListener l)`	Удалить `PropertyChangeListener` из списка слушателей.
`void`	`requestFocus()`	Запрашивает фокус для этого объекта.
`void`	`setAccessibleDescription(String s)`	Установить описание доступности этого объекта.
`void`	`setAccessibleName(String s)`	Установить имя этого объекта.
`void`	`setBackground(Color c)`	Установить фоновый `Color` этого объекта.
`void`	`setBounds(Rectangle r)`	Устанавливает текущие границы этого объекта.
`void`	`setCursor(Cursor c)`	Установить `Cursor` этого объекта.
`void`	`setEnabled(boolean b)`	Установить состояние включения объекта.
`void`	`setFont(Font f)`	Установить `Font` этого объекта.
`void`	`setForeground(Color c)`	Установить фоновый `Color` этого объекта.
`void`	`setLocation(Point p)`	Устанавливает расположение объекта относительно родителя.
`void`	`setSize(Dimension d)`	Устанавливает текущий размер этого объекта.
`void`	`setSource(Object o)`	Установить объект-источник `Translator`.
`void`	`setVisible(boolean b)`	Установить состояние видимости объекта.

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

firePropertyChange, getAccessibleAction, getAccessibleComponent, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleSelection, getAccessibleTable, getAccessibleText, getAccessibleValue, setAccessibleParent

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

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

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

source

protected Object source

Объект-источник, требующий перевода.

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

Translator

public Translator()

Создать новый Translator. После вызова этого конструктора необходимо вызвать метод setSource, чтобы установить объект, который нужно перевести.

Translator

public Translator(Object o)

Создать новый Translator с объектом-источником o.

Parameters:: o - компонент, не реализующий интерфейс Accessible

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

getTranslatorClass

protected static Class<?> getTranslatorClass(Class<?> c)

Найти переводчик для данного класса. Если такого переводчика нет для данного класса явно, то попробуйте его суперкласс и так далее.

Parameters:: c - класс
Returns:: класс Translator для переданного класса

getAccessible

public static Accessible getAccessible(Object o)

Получить объект, реализующий интерфейс Accessible. Если переданный объект уже реализует интерфейс Accessible, getAccessible просто возвращает объект.

Parameters:: o - объект; если передан null, возвращается null
Returns:: объект Object, возможно, переданный Object, реализующий интерфейс Accessible для переданного Object

getSource

public Object getSource()

Получить исходный Object объекта Translator.

Returns:: исходный Object объекта Translator

setSource

public void setSource(Object o)

Установить исходный объект объекта Translator.

Parameters:: o - компонент, не реализующий интерфейс Accessible

equals

public boolean equals(Object o)

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

Overrides:

equals в классе Object

Parameters:

o - объект для сравнения

Returns:

true, если это тот же объект

See Also:

hashCode

public int hashCode()

Возвращает хэш-код.

Overrides:

hashCode в классе Object

Returns:

хэш-код

See Also:

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Specified by:: getAccessibleContext в интерфейсе Accessible
Returns:: объект AccessibleContext связанный с этим объектом

getAccessibleName

public String getAccessibleName()

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

Overrides:

getAccessibleName в классе AccessibleContext

Returns:

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

See Also:

setAccessibleName

public void setAccessibleName(String s)

Установить имя этого объекта.

Overrides:

setAccessibleName в классе AccessibleContext

Parameters:

s - новое локализованное имя объекта

See Also:

getAccessibleDescription

public String getAccessibleDescription()

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

Overrides:

getAccessibleDescription в классе AccessibleContext

Returns:

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

See Also:

setAccessibleDescription

public void setAccessibleDescription(String s)

Установить доступное описание этого объекта.

Overrides:

setAccessibleDescription в классе AccessibleContext

Parameters:

s - новое локализованное описание объекта

See Also:

getAccessibleRole

public AccessibleRole getAccessibleRole()

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

Specified by:

getAccessibleRole в классе AccessibleContext

Returns:

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

See Also:

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()

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

Specified by:

getAccessibleStateSet в классе AccessibleContext

Returns:

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

See Also:

getAccessibleParent

public Accessible getAccessibleParent()

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

Overrides:: getAccessibleParent в классе AccessibleContext
Returns:: доступный родитель этого объекта; может быть null, если у этого объекта нет доступного родителя

getAccessibleIndexInParent

public int getAccessibleIndexInParent()

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

Specified by:

getAccessibleIndexInParent в классе AccessibleContext

Returns:

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

See Also:

getAccessibleChildrenCount

public int getAccessibleChildrenCount()

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

Specified by:: getAccessibleChildrenCount в классе AccessibleContext
Returns:: количество доступных дочерних элементов в объекте

getAccessibleChild

public Accessible getAccessibleChild(int i)

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

Specified by:

getAccessibleChild в классе AccessibleContext

Parameters:

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

Returns:

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

See Also:

getLocale

public Locale getLocale() throws IllegalComponentStateException

Получает Locale компонента. Если у компонента нет своего локали, возвращается локали родительского компонента.

Specified by:: getLocale in class AccessibleContext
Returns:: локали объекта
Throws:: IllegalComponentStateException - Если у компонента нет собственной локали и он ещё не добавлен в иерархию контейнеров, так что локали нельзя определить по родительскому элементу

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener l)

Добавляет PropertyChangeListener в список слушателей. Слушатель регистрируется для всех свойств.

Overrides:

addPropertyChangeListener in class AccessibleContext

Parameters:

l - Добавляемый слушатель свойств

See Also:

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener l)

Удаляет PropertyChangeListener из списка слушателей.

Overrides:: removePropertyChangeListener in class AccessibleContext
Parameters:: l - Слушатель свойств для удаления

getBackground

public Color getBackground()

Получить фоновый Color этого объекта.

Specified by:

getBackground in interface AccessibleComponent

Returns:

если поддерживается, фоновый Color объекта; иначе, null

See Also:

setBackground

public void setBackground(Color c)

Установить фоновый Color этого объекта.

Specified by:

setBackground in interface AccessibleComponent

Parameters:

c - новое Color для фона

See Also:

getForeground

public Color getForeground()

Получить фоновый Color этого объекта.

Specified by:

getForeground in interface AccessibleComponent

Returns:

если поддерживается, фоновый Color объекта; иначе, null

See Also:

setForeground

public void setForeground(Color c)

Установить фоновый Color этого объекта.

Specified by:

setForeground in interface AccessibleComponent

Parameters:

c - новое Color для переднего плана

See Also:

getCursor

public Cursor getCursor()

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

Specified by:

getCursor in interface AccessibleComponent

Returns:

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

See Also:

setCursor

public void setCursor(Cursor c)

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

Specified by:

setCursor in interface AccessibleComponent

Parameters:

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

See Also:

getFont

public Font getFont()

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

Specified by:

getFont in interface AccessibleComponent

Returns:

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

See Also:

setFont

public void setFont(Font f)

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

Specified by:

setFont in interface AccessibleComponent

Parameters:

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

See Also:

getFontMetrics

public FontMetrics getFontMetrics(Font f)

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

Specified by:

getFontMetrics in interface AccessibleComponent

Parameters:

f - Font

Returns:

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

See Also:

isEnabled

public boolean isEnabled()

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

Specified by:

isEnabled in interface AccessibleComponent

Returns:

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

See Also:

setEnabled

public void setEnabled(boolean b)

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

Specified by:

setEnabled in interface AccessibleComponent

Parameters:

b - true, чтобы включить объект; иначе, отключить

See Also:

isVisible

public boolean isVisible()

Определить, видим ли объект.

Specified by:

isVisible in interface AccessibleComponent

Returns:

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

See Also:

setVisible

public void setVisible(boolean b)

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

Specified by:

setVisible in interface AccessibleComponent

Parameters:

b - true, чтобы показать объект; иначе, скрыть

See Also:

isShowing

public boolean isShowing()

Определяет, отображается ли объект. Это определяется проверкой видимости объекта и его предков.

Указано в:: isShowing в интерфейсе AccessibleComponent
Возвращает:: true, если объект отображается; иначе, false

contains

public boolean contains(Point p)

Проверяет, находится ли указанная Point внутри границ этого объекта, где Point относится к системе координат объекта.

Указано в:

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

Параметры:

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

Возвращает:

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

См. также:

getLocationOnScreen

public Point getLocationOnScreen()

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

Указано в:

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

Возвращает:

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

См. также:

getLocation

public Point getLocation()

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

Указано в:

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

Возвращает:

положение объекта относительно родителя; может быть null, если этот объект или его родитель не находятся на экране

См. также:

setLocation

public void setLocation(Point p)

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

Указано в:

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

Параметры:

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

См. также:

getBounds

public Rectangle getBounds()

Возвращает текущие границы этого объекта.

Указано в:

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

Возвращает:

текущие границы объекта; может быть null, если этот объект не находится на экране

См. также:

setBounds

public void setBounds(Rectangle r)

Устанавливает текущие границы этого объекта.

Указано в:

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

Параметры:

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

См. также:

getSize

public Dimension getSize()

Возвращает текущий размер этого объекта.

Указано в:

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

Возвращает:

текущий размер объекта; может быть null, если этот объект не находится на экране

См. также:

setSize

public void setSize(Dimension d)

Устанавливает текущий размер этого объекта.

Указано в:

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

Параметры:

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

См. также:

getAccessibleAt

public Accessible getAccessibleAt(Point p)

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

Указано в:: getAccessibleAt в интерфейсе AccessibleComponent
Параметры:: p - точка относительно системы координат этого объекта
Возвращает:: Элемент Accessible в указанном месте, если он существует

isFocusTraversable

public boolean isFocusTraversable()

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

Указано в:

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

Возвращает:

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

См. также:

requestFocus

public void requestFocus()

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

Указано в:

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

См. также:

addFocusListener

public void addFocusListener(FocusListener l)

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

Указано в:

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

Параметры:

l - обработчик событий фокуса

См. также:

removeFocusListener

public void removeFocusListener(FocusListener l)

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

Указано в:

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

Параметры:

l - обработчик событий фокуса; этот метод не выполняет никакой функции и не генерирует исключение, если указанный обработчик ранее не был добавлен в этот компонент; если listener равен null, исключение не генерируется, и действие не выполняется.

См. также:

© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/jdk.accessibility/com/sun/java/accessibility/util/Translator.html