Класс 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

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

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

Переводчик

public Translator()

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

Переводчик

public Translator(Object o)

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

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

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

getTranslatorClass

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

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

Параметры:: c - класс
Возвращает:: класс Translator для переданного класса

getAccessible

public static Accessible getAccessible(Object o)

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

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

getSource

public Object getSource()

Получить источник Object Translator.

Возвращает:: источник Object Translator

setSource

public void setSource(Object o)

Установить объект источника Translator.

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

equals

public boolean equals(Object o)

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

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

hashCode

public int hashCode()

Возвратить хэш-код.

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

hashCode в классе Object

Возвращает:

хэш-код

См. также:

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Возвращает:: AccessibleContext, связанный с этим объектом

getAccessibleName

public String getAccessibleName()

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

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

getAccessibleName в классе AccessibleContext

Возвращает:

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

См. также:

setAccessibleName

public void setAccessibleName(String s)

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

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

setAccessibleName в классе AccessibleContext

Параметры:

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

См. также:

getAccessibleDescription

public String getAccessibleDescription()

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

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

getAccessibleDescription в классе AccessibleContext

Возвращает:

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

См. также:

setAccessibleDescription

public void setAccessibleDescription(String s)

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

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

setAccessibleDescription в классе AccessibleContext

Параметры:

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

См. также:

getAccessibleRole

public AccessibleRole getAccessibleRole()

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

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

getAccessibleRole в классе AccessibleContext

Возвращает:

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

См. также:

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()

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

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

getAccessibleStateSet в классе AccessibleContext

Возвращает:

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

См. также:

getAccessibleParent

public Accessible getAccessibleParent()

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

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

getAccessibleIndexInParent

public int getAccessibleIndexInParent()

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

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

getAccessibleIndexInParent в классе AccessibleContext

Возвращает:

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

См. также:

getAccessibleChildrenCount

public int getAccessibleChildrenCount()

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

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

getAccessibleChild

public Accessible getAccessibleChild(int i)

Возвращает n-го доступного дочернего объекта.

Specified by:

getAccessibleChild in class 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)

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

Overrides:

addPropertyChangeListener in class AccessibleContext

Parameters:

l - Слушатель изменений свойств для добавления

See Also:

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener l)

Удаляет слушателя изменений свойств из списка слушателей.

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

getBackground

public Color getBackground()

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

Specified by:

getBackground in interface AccessibleComponent

Returns:

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

See Also:

setBackground

public void setBackground(Color c)

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

Specified by:

setBackground in interface AccessibleComponent

Parameters:

c - новый цвет фона

See Also:

getForeground

public Color getForeground()

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

Specified by:

getForeground in interface AccessibleComponent

Returns:

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

See Also:

setForeground

public void setForeground(Color c)

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

Specified by:

setForeground in interface AccessibleComponent

Parameters:

c - новый цвет переднего плана

See Also:

getCursor

public Cursor getCursor()

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

Specified by:

getCursor in interface AccessibleComponent

Returns:

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

See Also:

setCursor

public void setCursor(Cursor c)

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

Specified by:

setCursor in interface AccessibleComponent

Parameters:

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

See Also:

getFont

public Font getFont()

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

Specified by:

getFont in interface AccessibleComponent

Returns:

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

See Also:

setFont

public void setFont(Font f)

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

Specified by:

setFont in interface AccessibleComponent

Parameters:

f - новый шрифт для объекта

See Also:

getFontMetrics

public FontMetrics getFontMetrics(Font f)

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

Specified by:

getFontMetrics in interface AccessibleComponent

Parameters:

f - шрифт

Returns:

если поддерживается, метрики шрифта объекта; в противном случае, 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()

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

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

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

Возвращает:

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

См. также:

setVisible

public void setVisible(boolean b)

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

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

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

Параметры:

b - если true, отображает этот объект; в противном случае, скрывает его

См. также:

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 - Точка, относительная к системе координат этого объекта
Возвращает:: Доступный элемент в указанном месте, если он существует

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, 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/jdk.accessibility/com/sun/java/accessibility/util/Translator.html