Spec-Zone.ru › OpenJDK 24

Класс 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() для определения своего поведения. Они не должны включать код, подобный switch, который использует константы, такие как:
 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()
HorizontalLines: Элементы идут слева направо?

Методы, объявленные в классе java.lang.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()
HorizontalLines: Элементы идут слева направо?
Vertical Lines: Линии идут слева направо?
Возвращает 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 - используемый пакет ресурсов
Возвращает:
ориентация

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

Spec-Zone.ru

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