Spec-Zone.ru › OpenJDK 25

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

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

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, 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/java.desktop/java/awt/ComponentOrientation.html

Spec-Zone.ru

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