Spec-Zone.ru › OpenJDK 17

Класс 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, 2021, 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/17/docs/api/java.desktop/java/awt/ComponentOrientation.html

Spec-Zone.ru

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