Spec-Zone.ru › OpenJDK 27

Класс ComponentOrientation

java.lang.Object
java.awt.ComponentOrientation
Все реализованные интерфейсы:
Serializable
public final class ComponentOrientation extends Object implements Serializable
Класс ComponentOrientation инкапсулирует зависящий от языка порядок, используемый для расположения элементов компонента или текста. Он отражает различия в этом порядке между западными алфавитами, алфавитами Ближнего Востока (например, ивритом) и Дальнего Востока (например, японским).

По существу, этот порядок определяет размещение элементов (например, символов) в строках, а затем расположение строк в блоке. Он также применяется к элементам виджета: например, к положению флажка относительно текста.

В современных языках используются четыре различных ориентации, представленные в следующей таблице.

LT          RT          TL          TR
A B C       C B A       A D G       G D A
D E F       F E D       B E H       H E B
G H I       I H G       C F I       I F C

(В заголовке двухбуквенное сокращение обозначает направление элементов первой буквой, а направление строк — второй. Например, LT означает «элементы слева направо, строки сверху вниз», TL означает «элементы сверху вниз, строки слева направо» и так далее.)

Используются следующие ориентации:

  • LT — Западная Европа (также применимо для японского, китайского и корейского языков)
  • RT — Ближний Восток (арабский, иврит)
  • TR — японский, китайский, корейский
  • TL — монгольский
Компоненты, код представления и контроллера которых зависит от ориентации, должны использовать методы isLeftToRight() и isHorizontal() для определения своего поведения. Не следует использовать конструкции с переключением, в которых проверяются константы, например:
if (orientation == LEFT_TO_RIGHT) {
  ...
} else if (orientation == RIGHT_TO_LEFT) {
  ...
} else {
  // Oops
}
Это небезопасно, поскольку в будущем могут быть добавлены другие константы, а уникальность объектов ориентации не гарантируется.
См. также:
  • Форма сериализации

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

Модификатор и тип Поле Описание
static final ComponentOrientation LEFT_TO_RIGHT
Элементы располагаются слева направо, а строки — сверху вниз. Примеры: английский, французский.
static final ComponentOrientation RIGHT_TO_LEFT
Элементы располагаются справа налево, а строки — сверху вниз. Примеры: арабский, иврит.
static final ComponentOrientation UNKNOWN
Указывает, что ориентация компонента не задана.

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

Модификатор и тип Метод Описание
static ComponentOrientation getOrientation(Locale locale)
Возвращает ориентацию, соответствующую заданной локали.
static ComponentOrientation getOrientation(ResourceBundle bdl)
Устарело.
Начиная с J2SE 1.4, используйте getOrientation(java.util.Locale).
boolean isHorizontal()
Являются ли строки горизонтальными?
boolean isLeftToRight()
Горизонтальные строки: располагаются ли элементы слева направо?

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 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()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

LEFT_TO_RIGHT

public static final ComponentOrientation LEFT_TO_RIGHT
Элементы располагаются слева направо, а строки — сверху вниз. Примеры: английский, французский.

RIGHT_TO_LEFT

public static final ComponentOrientation RIGHT_TO_LEFT
Элементы располагаются справа налево, а строки — сверху вниз. Примеры: арабский, иврит.

UNKNOWN

public static final ComponentOrientation UNKNOWN
Указывает, что ориентация компонента не задана. Для сохранения поведения существующих приложений метод isLeftToRight возвращает true для этого значения.

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

isHorizontal

public boolean isHorizontal()
Являются ли строки горизонтальными? Этот метод возвращает true для горизонтальных систем письма слева направо, например латинской.
Возвращает:
true если строки в этой ориентации горизонтальные

isLeftToRight

public boolean isLeftToRight()
Горизонтальные строки: располагаются ли элементы слева направо?
Вертикальные строки: располагаются ли строки слева направо?
Этот метод возвращает true для горизонтальных систем письма слева направо, например латинской.
Возвращает:
true если в этой ориентации используется направление слева направо

getOrientation

public static ComponentOrientation getOrientation(Locale locale)
Возвращает ориентацию, соответствующую заданной локали.
Параметры:
locale — заданная локаль
Возвращает:
ориентацию для локали

getOrientation

@Deprecated public static ComponentOrientation getOrientation(ResourceBundle bdl)
Устарело.
Начиная с J2SE 1.4, используйте getOrientation(java.util.Locale).
Возвращает ориентацию, соответствующую локализации заданного ResourceBundle. Проверяются три варианта в следующем порядке:
  1. Извлечение объекта ComponentOrientation из ResourceBundle по строковому ключу "Orientation".
  2. Определение локали пакета с помощью ResourceBundle.getLocale и возврат ориентации для этой локали.
  3. Возврат ориентации локали по умолчанию.
Параметры:
bdl — используемый пакет
Возвращает:
ориентацию

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по 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