Spec-Zone.ru › OpenJDK 25

Класс перечисления Component.BaselineResizeBehavior

java.lang.Object
java.lang.Enum<Component.BaselineResizeBehavior>
java.awt.Component.BaselineResizeBehavior
Все реализуемые интерфейсы:
Serializable, Comparable<Component.BaselineResizeBehavior>, Constable
Внешний класс:
Component
public static enum Component.BaselineResizeBehavior extends Enum<Component.BaselineResizeBehavior>
Перечисление распространённых способов изменения базовой линии компонента при изменении его размера. Поведение базовой линии при изменении размера предназначено главным образом для менеджеров компоновки, которым необходимо знать, как меняется положение базовой линии при изменении размера компонента. В целом поведение базовой линии при изменении размера будет корректным для размеров, больших или равных минимальному размеру (фактическому минимальному размеру, а не минимальному размеру, заданному разработчиком). Для размеров меньше минимального базовая линия может изменяться не так, как указано поведением при изменении размера. Аналогично, при приближении размера к Integer.MAX_VALUE и/или Short.MAX_VALUE базовая линия может изменяться не так, как указано поведением при изменении размера.
Начиная с:
1.6
См. также:
  • Component.getBaselineResizeBehavior()
  • Component.getBaseline(int,int)

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в классе Enum

Enum.EnumDesc<E>

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

Константа перечисления Описание
CENTER_OFFSET
Указывает, что базовая линия остаётся на фиксированном расстоянии от центра компонента.
CONSTANT_ASCENT
Указывает, что базовая линия остаётся неподвижной относительно начала координат по y.
CONSTANT_DESCENT
Указывает, что базовая линия остаётся неподвижной относительно высоты и не изменяется при изменении ширины.
OTHER
Указывает, что поведение базовой линии при изменении размера не может быть описано ни одной из остальных констант.

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

Модификатор и тип Метод Описание
static Component.BaselineResizeBehavior valueOf(String name)
Возвращает константу перечисления этого класса с указанным именем.
static Component.BaselineResizeBehavior[] values()
Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.

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

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

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

getClass, notify, notifyAll, wait, wait, wait

Подробное описание констант перечисления

CONSTANT_ASCENT

public static final Component.BaselineResizeBehavior CONSTANT_ASCENT
Указывает, что базовая линия остаётся неподвижной относительно начала координат по y. То есть getBaseline возвращает одно и то же значение независимо от высоты или ширины. Например, JLabel, содержащий непустой текст с вертикальным выравниванием TOP, должен иметь тип базовой линии CONSTANT_ASCENT.

CONSTANT_DESCENT

public static final Component.BaselineResizeBehavior CONSTANT_DESCENT
Указывает, что базовая линия остаётся неподвижной относительно высоты и не изменяется при изменении ширины. То есть для любой высоты H разность между H и getBaseline(w, H) остаётся неизменной. Например, JLabel, содержащий непустой текст с вертикальным выравниванием BOTTOM, должен иметь тип базовой линии CONSTANT_DESCENT.

CENTER_OFFSET

public static final Component.BaselineResizeBehavior CENTER_OFFSET
Указывает, что базовая линия остаётся на фиксированном расстоянии от центра компонента. То есть для любой высоты H разность между getBaseline(w, H) и H / 2 остаётся неизменной (с поправкой в плюс или минус единицу на погрешность округления).

Из-за возможных погрешностей округления рекомендуется запрашивать базовую линию для двух последовательных значений высоты и использовать возвращаемое значение, чтобы определить, нужно ли учитывать в вычислениях поправку в 1. Ниже показано, как вычислить базовую линию для любой высоты:

  Dimension preferredSize = component.getPreferredSize();
  int baseline = getBaseline(preferredSize.width,
                             preferredSize.height);
  int nextBaseline = getBaseline(preferredSize.width,
                                 preferredSize.height + 1);
  // Amount to add to height when calculating where baseline
  // lands for a particular height:
  int padding = 0;
  // Where the baseline is relative to the mid point
  int baselineOffset = baseline - height / 2;
  if (preferredSize.height % 2 == 0 &&
      baseline != nextBaseline) {
      padding = 1;
  }
  else if (preferredSize.height % 2 == 1 &&
           baseline == nextBaseline) {
      baselineOffset--;
      padding = 1;
  }
  // The following calculates where the baseline lands for
  // the height z:
  int calculatedBaseline = (z + padding) / 2 + baselineOffset;

OTHER

public static final Component.BaselineResizeBehavior OTHER
Указывает, что поведение базовой линии при изменении размера не может быть описано ни одной из остальных констант. Это также может указывать на то, что базовая линия меняется в зависимости от ширины компонента. Это значение также возвращается компонентами, у которых нет базовой линии.

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

values

public static Component.BaselineResizeBehavior[] values()
Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.
Возвращает:
массив, содержащий константы этого класса перечисления в порядке их объявления

valueOf

public static Component.BaselineResizeBehavior valueOf(String name)
Возвращает константу перечисления этого класса с указанным именем. Строка должна точно совпадать с идентификатором, использованным для объявления константы перечисления в этом классе. (Пробелы в начале и конце строки не допускаются.)
Параметры:
name — имя возвращаемой константы перечисления.
Возвращает:
константу перечисления с указанным именем
Вызывает исключение:
IllegalArgumentException — если в этом классе перечисления нет константы с указанным именем
NullPointerException — если аргумент равен null

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по 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/Component.BaselineResizeBehavior.html

Spec-Zone.ru

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