Spec-Zone.ru › OpenJDK 21

Класс ComponentOrientation

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

В основе лежит управление элементами (такими как символы), которые выкладываются в строки, а затем строки выкладываются в блок. Это также относится к элементам в виджете: например, в флажке, где рамка расположена относительно текста.

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

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

Spec-Zone.ru

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