Spec-Zone.ru › OpenJDK 25

Класс 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
Исходный объект, требующий преобразования.

Поля, объявленные в классе 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)
Задает состояние видимости объекта.

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

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

Методы, объявленные в классе 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.
Параметры:
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, если это тот же объект
См. также:
  • Object.hashCode()
  • HashMap

hashCode

public int hashCode()
Возвращает хеш-код.
Переопределяет:
hashCode в классе Object
Возвращает:
хеш-код
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(Object)

getAccessibleContext

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

getAccessibleName

public String getAccessibleName()
Возвращает доступное имя этого объекта.
Переопределяет:
getAccessibleName в классе AccessibleContext
Возвращает:
локализованное имя объекта; может быть null, если у объекта нет имени
См. также:
  • AccessibleContext.setAccessibleName(String)

setAccessibleName

public void setAccessibleName(String s)
Задает имя этого объекта.
Переопределяет:
setAccessibleName в классе AccessibleContext
Параметры:
s — новое локализованное имя объекта
См. также:
  • AccessibleContext.getAccessibleName()
  • AccessibleContext.addPropertyChangeListener(PropertyChangeListener)

getAccessibleDescription

public String getAccessibleDescription()
Возвращает доступное описание этого объекта.
Переопределяет:
getAccessibleDescription в классе AccessibleContext
Возвращает:
описание объекта; может быть null, если у объекта нет описания
См. также:
  • AccessibleContext.setAccessibleDescription(String)

setAccessibleDescription

public void setAccessibleDescription(String s)
Задает доступное описание этого объекта.
Переопределяет:
setAccessibleDescription в классе AccessibleContext
Параметры:
s — новое локализованное описание объекта
См. также:
  • AccessibleContext.setAccessibleName(String)
  • AccessibleContext.addPropertyChangeListener(PropertyChangeListener)

getAccessibleRole

public AccessibleRole getAccessibleRole()
Возвращает роль этого объекта.
Определено в:
getAccessibleRole в классе AccessibleContext
Возвращает:
экземпляр AccessibleRole, описывающий роль объекта
См. также:
  • AccessibleRole

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()
Возвращает состояние этого объекта с учетом уже заполненного набора состояний. Этот метод предназначен для использования подклассами, чтобы им не приходилось проверять все самостоятельно.
Определено в:
getAccessibleStateSet в классе AccessibleContext
Возвращает:
экземпляр AccessibleStateSet, содержащий текущее состояние объекта
См. также:
  • AccessibleStateSet
  • AccessibleState
  • AccessibleContext.addPropertyChangeListener(PropertyChangeListener)

getAccessibleParent

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

getAccessibleIndexInParent

public int getAccessibleIndexInParent()
Возвращает индекс этого объекта в его доступном родительском объекте.
Определено в:
getAccessibleIndexInParent в классе AccessibleContext
Возвращает:
-1, если у этого объекта нет доступного родительского объекта; в противном случае индекс дочернего объекта в его доступном родительском объекте
См. также:
  • AccessibleContext.getAccessibleParent()
  • AccessibleContext.getAccessibleChildrenCount()
  • AccessibleContext.getAccessibleChild(int)

getAccessibleChildrenCount

public int getAccessibleChildrenCount()
Возвращает количество доступных дочерних объектов.
Определено в:
getAccessibleChildrenCount в классе AccessibleContext
Возвращает:
количество доступных дочерних объектов

getAccessibleChild

public Accessible getAccessibleChild(int i)
Возвращает n-й доступный дочерний объект.
Определено в:
getAccessibleChild в классе AccessibleContext
Параметры:
i — индекс дочернего объекта, начиная с нуля
Возвращает:
n-й доступный дочерний объект
См. также:
  • AccessibleContext.getAccessibleChildrenCount()

getLocale

public Locale getLocale() throws IllegalComponentStateException
Возвращает Locale компонента. Если у компонента нет локали, возвращается локаль его родительского компонента.
Определено в:
getLocale в классе AccessibleContext
Возвращает:
Locale объекта
Вызывает исключение:
IllegalComponentStateException — если у компонента нет собственной локали и он еще не добавлен в иерархию контейнеров, из которой можно определить локаль по содержащему родительскому компоненту

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener l)
Добавляет PropertyChangeListener в список слушателей. Слушатель регистрируется для всех свойств.
Переопределяет:
addPropertyChangeListener в классе AccessibleContext
Параметры:
l — слушатель PropertyChangeListener, который нужно добавить
См. также:
  • AccessibleContext.ACCESSIBLE_NAME_PROPERTY
  • AccessibleContext.ACCESSIBLE_DESCRIPTION_PROPERTY
  • AccessibleContext.ACCESSIBLE_STATE_PROPERTY
  • AccessibleContext.ACCESSIBLE_VALUE_PROPERTY
  • AccessibleContext.ACCESSIBLE_SELECTION_PROPERTY
  • AccessibleContext.ACCESSIBLE_TEXT_PROPERTY
  • AccessibleContext.ACCESSIBLE_VISIBLE_DATA_PROPERTY

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener l)
Удаляет PropertyChangeListener из списка слушателей.
Переопределяет:
removePropertyChangeListener в классе AccessibleContext
Параметры:
l — слушатель PropertyChangeListener, который нужно удалить

getBackground

public Color getBackground()
Возвращает цвет фона Color этого объекта.
Определено в:
getBackground в интерфейсе AccessibleComponent
Возвращает:
если поддерживается, цвет фона Color объекта; в противном случае null
См. также:
  • AccessibleComponent.setBackground(Color)

setBackground

public void setBackground(Color c)
Задает цвет фона Color этого объекта.
Определено в:
setBackground в интерфейсе AccessibleComponent
Параметры:
c — новый Color для фона
См. также:
  • AccessibleComponent.getBackground()

getForeground

public Color getForeground()
Возвращает цвет переднего плана Color этого объекта.
Определено в:
getForeground в интерфейсе AccessibleComponent
Возвращает:
если поддерживается, цвет переднего плана Color объекта; в противном случае null
См. также:
  • AccessibleComponent.setForeground(Color)

setForeground

public void setForeground(Color c)
Задает цвет переднего плана Color этого объекта.
Определено в:
setForeground в интерфейсе AccessibleComponent
Параметры:
c — новый Color переднего плана
См. также:
  • AccessibleComponent.getForeground()

getCursor

public Cursor getCursor()
Возвращает Cursor этого объекта.
Определено в:
getCursor в интерфейсе AccessibleComponent
Возвращает:
если поддерживается, курсор объекта; в противном случае null
См. также:
  • AccessibleComponent.setCursor(Cursor)

setCursor

public void setCursor(Cursor c)
Задает Cursor этого объекта.
Определено в:
setCursor в интерфейсе AccessibleComponent
Параметры:
c — новый Cursor объекта
См. также:
  • AccessibleComponent.getCursor()

getFont

public Font getFont()
Возвращает Font этого объекта.
Определено в:
getFont в интерфейсе AccessibleComponent
Возвращает:
если поддерживается, Font объекта; в противном случае null
См. также:
  • AccessibleComponent.setFont(Font)

setFont

public void setFont(Font f)
Задает Font этого объекта.
Определено в:
setFont в интерфейсе AccessibleComponent
Параметры:
f — новый Font объекта
См. также:
  • AccessibleComponent.getFont()

getFontMetrics

public FontMetrics getFontMetrics(Font f)
Возвращает FontMetrics этого объекта.
Определено в:
getFontMetrics в интерфейсе AccessibleComponent
Параметры:
f — Font
Возвращает:
если поддерживается, FontMetrics объекта; в противном случае null
См. также:
  • getFont()

isEnabled

public boolean isEnabled()
Определяет, включен ли объект.
Определено в:
isEnabled в интерфейсе AccessibleComponent
Возвращает:
true, если объект включен; в противном случае false
См. также:
  • AccessibleComponent.setEnabled(boolean)
  • AccessibleContext.getAccessibleStateSet()
  • AccessibleState.ENABLED
  • AccessibleStateSet

setEnabled

public void setEnabled(boolean b)
Задает состояние включения объекта.
Определено в:
setEnabled в интерфейсе AccessibleComponent
Параметры:
b — если true, включает этот объект; в противном случае отключает его
См. также:
  • AccessibleComponent.isEnabled()

isVisible

public boolean isVisible()
Определяет, виден ли объект.
Определено в:
isVisible в интерфейсе AccessibleComponent
Возвращает:
true, если объект виден; в противном случае false
См. также:
  • AccessibleComponent.setVisible(boolean)
  • AccessibleContext.getAccessibleStateSet()
  • AccessibleState.VISIBLE
  • AccessibleStateSet

setVisible

public void setVisible(boolean b)
Задает видимое состояние объекта.
Определено в:
setVisible в интерфейсе AccessibleComponent
Параметры:
b — если true, показывает этот объект; в противном случае скрывает его
См. также:
  • AccessibleComponent.isVisible()

isShowing

public boolean isShowing()
Определяет, отображается ли объект. Это определяется путем проверки видимости объекта и его предков.
Определено в:
isShowing в интерфейсе AccessibleComponent
Возвращает:
true, если объект отображается; в противном случае false

contains

public boolean contains(Point p)
Проверяет, находится ли указанная Point в пределах границ этого объекта, где Point задана относительно системы координат объекта.
Определено в:
contains в интерфейсе AccessibleComponent
Параметры:
p — Point относительно системы координат объекта
Возвращает:
true, если объект содержит Point; в противном случае false
См. также:
  • AccessibleComponent.getBounds()

getLocationOnScreen

public Point getLocationOnScreen()
Возвращает расположение объекта на экране.
Определено в:
getLocationOnScreen в интерфейсе AccessibleComponent
Возвращает:
расположение объекта на экране; может быть null, если объект не находится на экране
См. также:
  • AccessibleComponent.getBounds()
  • AccessibleComponent.getLocation()

getLocation

public Point getLocation()
Возвращает расположение объекта относительно родительского объекта.
Определено в:
getLocation в интерфейсе AccessibleComponent
Возвращает:
расположение объекта относительно родительского объекта; может быть null, если этот объект или его родительский объект не находятся на экране
См. также:
  • AccessibleComponent.getBounds()
  • AccessibleComponent.getLocationOnScreen()

setLocation

public void setLocation(Point p)
Задает расположение объекта относительно родительского объекта.
Определено в:
setLocation в интерфейсе AccessibleComponent
Параметры:
p — новое положение верхнего левого угла
См. также:
  • AccessibleComponent.getLocation()

getBounds

public Rectangle getBounds()
Возвращает текущие границы этого объекта.
Определено в:
getBounds в интерфейсе AccessibleComponent
Возвращает:
текущие границы объекта; может быть null, если объект не находится на экране
См. также:
  • AccessibleComponent.contains(Point)

setBounds

public void setBounds(Rectangle r)
Задает текущие границы этого объекта.
Определено в:
setBounds в интерфейсе AccessibleComponent
Параметры:
r — прямоугольник, задающий границы этого компонента
См. также:
  • AccessibleComponent.getBounds()

getSize

public Dimension getSize()
Возвращает текущий размер этого объекта.
Определено в:
getSize в интерфейсе AccessibleComponent
Возвращает:
текущий размер объекта; может быть null, если объект не находится на экране
См. также:
  • AccessibleComponent.setSize(Dimension)

setSize

public void setSize(Dimension d)
Задает текущий размер этого объекта.
Определено в:
setSize в интерфейсе AccessibleComponent
Параметры:
d — размер, задающий новый размер объекта
См. также:
  • AccessibleComponent.getSize()

getAccessibleAt

public Accessible getAccessibleAt(Point p)
Возвращает доступный дочерний объект, находящийся в локальной точке Point, если такой объект существует.
Определено в:
getAccessibleAt в интерфейсе AccessibleComponent
Параметры:
p — точка относительно системы координат этого объекта
Возвращает:
объект Accessible в указанном расположении, если он существует

isFocusTraversable

public boolean isFocusTraversable()
Возвращает, может ли этот объект получать фокус.
Указано в:
isFocusTraversable в интерфейсе AccessibleComponent
Возвращает:
true, если объект может получать фокус; в противном случае — false
См. также:
  • AccessibleContext.getAccessibleStateSet()
  • AccessibleState.FOCUSABLE
  • AccessibleState.FOCUSED
  • AccessibleStateSet

requestFocus

public void requestFocus()
Запрашивает фокус для этого объекта.
Указано в:
requestFocus в интерфейсе AccessibleComponent
См. также:
  • AccessibleComponent.isFocusTraversable()

addFocusListener

public void addFocusListener(FocusListener l)
Добавляет указанный FocusListener для получения событий фокуса от этого компонента.
Указано в:
addFocusListener в интерфейсе AccessibleComponent
Параметры:
l — слушатель фокуса
См. также:
  • AccessibleComponent.removeFocusListener(FocusListener)

removeFocusListener

public void removeFocusListener(FocusListener l)
Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента.
Указано в:
removeFocusListener в интерфейсе AccessibleComponent
Параметры:
l — слушатель фокуса; этот метод ничего не делает и не выбрасывает исключение, если указанный слушатель ранее не был добавлен к этому компоненту; если listener равен null, исключение не выбрасывается и никаких действий не выполняется.
См. также:
  • AccessibleComponent.addFocusListener(FocusListener)

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/jdk.accessibility/com/sun/java/accessibility/util/Translator.html

Spec-Zone.ru

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