Spec-Zone.ru › OpenJDK 21

Класс CardLayout

java.lang.Object
java.awt.CardLayout
Все реализуемые интерфейсы:
LayoutManager, LayoutManager2, Serializable 
public class CardLayout extends Object implements LayoutManager2, Serializable
Объект класса CardLayout является менеджером компоновки для контейнера. Он рассматривает каждый компонент в контейнере как карту. Одновременно видна только одна карта, и контейнер действует как стопка карт. Первый добавленный компонент в объект CardLayout является видимым компонентом при первом отображении контейнера.

Порядок карт определяется собственным внутренним порядком объектов компонентов контейнера. CardLayout определяет набор методов, которые позволяют приложению перелистывать эти карты последовательно или отображать указанную карту. Метод addLayoutComponent(java.awt.Component, java.lang.Object) может использоваться для сопоставления строкового идентификатора с данной картой для быстрого произвольного доступа.

С:
1.0
См. также:
  • Container
  • Сериализованная форма

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

Конструктор Описание
CardLayout()
Создаёт новый менеджер компоновки карт с отступами размером ноль.
CardLayout(int hgap, int vgap)
Создаёт новый менеджер компоновки карт с указанными горизонтальным и вертикальным отступами.

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

Модификатор и тип Метод Описание
void addLayoutComponent(Component comp, Object constraints)
Добавляет указанный компонент во внутреннюю таблицу имён менеджера компоновки карт.
void addLayoutComponent(String name, Component comp)
Устарел.
заменён на addLayoutComponent(Component, Object).
void first(Container parent)
Переходит к первой карте контейнера.
int getHgap()
Возвращает горизонтальный отступ между компонентами.
float getLayoutAlignmentX(Container parent)
Возвращает выравнивание по оси x.
float getLayoutAlignmentY(Container parent)
Возвращает выравнивание по оси y.
int getVgap()
Возвращает вертикальный отступ между компонентами.
void invalidateLayout(Container target)
Отменяет компоновку, указывая, что если менеджер компоновки кэшировал информацию, она должна быть удалена.
void last(Container parent)
Переходит к последней карте контейнера.
void layoutContainer(Container parent)
Компонует указанный контейнер с использованием менеджера компоновки карт.
Dimension maximumLayoutSize(Container target)
Возвращает максимальные размеры для этой компоновки, учитывая компоненты в указанном целевом контейнере.
Dimension minimumLayoutSize(Container parent)
Вычисляет минимальный размер для указанной панели.
void next(Container parent)
Переходит к следующей карте указанного контейнера.
Dimension preferredLayoutSize(Container parent)
Определяет предпочтительный размер аргумента контейнера с использованием этой компоновки карт.
void previous(Container parent)
Переходит к предыдущей карте указанного контейнера.
void removeLayoutComponent(Component comp)
Удаляет указанный компонент из компоновки.
void setHgap(int hgap)
Устанавливает горизонтальный отступ между компонентами.
void setVgap(int vgap)
Устанавливает вертикальный отступ между компонентами.
void show(Container parent, String name)
Переходит к компоненту, который был добавлен в эту компоновку с указанным name, используя addLayoutComponent.
String toString()
Возвращает строковое представление состояния этой компоновки карт.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

CardLayout

public CardLayout()
Создаёт новую компоновку карт с отступами размером ноль.

CardLayout

public CardLayout(int hgap, int vgap)
Создаёт новую компоновку карт с заданными горизонтальными и вертикальными отступами. Горизонтальные отступы размещаются по левому и правому краям. Вертикальные отступы размещаются по верхнему и нижнему краям.
Параметры:
hgap - горизонтальный отступ.
vgap - вертикальный отступ.

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

getHgap

public int getHgap()
Получает горизонтальный отступ между компонентами.
Возвращает:
горизонтальный отступ между компонентами.
С:
1.1
См. также:
  • setHgap(int)
  • getVgap()

setHgap

public void setHgap(int hgap)
Устанавливает горизонтальный отступ между компонентами.
Параметры:
hgap - горизонтальный отступ между компонентами.
С:
1.1
См. также:
  • getHgap()
  • setVgap(int)

getVgap

public int getVgap()
Получает вертикальный отступ между компонентами.
Возвращает:
вертикальный отступ между компонентами.
См. также:
  • setVgap(int)
  • getHgap()

setVgap

public void setVgap(int vgap)
Устанавливает вертикальный отступ между компонентами.
Параметры:
vgap - вертикальный отступ между компонентами.
С:
1.1
См. также:
  • getVgap()
  • setHgap(int)

addLayoutComponent

public void addLayoutComponent(Component comp, Object constraints)
Добавляет указанный компонент во внутреннюю таблицу имён компоновки карт. Объект, заданный посредством constraints, должен быть строкой. Компоновка карт хранит эту строку в виде пары ключ-значение, которая может использоваться для произвольного доступа к конкретной карте. Вызвав метод show, приложение может отобразить компонент с заданным именем.
Задано:
addLayoutComponent в интерфейсе LayoutManager2
Параметры:
comp - добавляемый компонент.
constraints - тег, идентифицирующий конкретную карту в компоновке.
Исключения:
IllegalArgumentException - если ограничение не является строкой.
См. также:
  • show(java.awt.Container, java.lang.String)

addLayoutComponent

@Deprecated public void addLayoutComponent(String name, Component comp)
Устарело.
заменено на addLayoutComponent(Component, Object).
Описание скопировано из интерфейса: LayoutManager
Если компоновщик макета использует строку для каждого компонента, добавляет компонент comp в макет, связывая его со строкой, заданной посредством name.
Задано:
addLayoutComponent в интерфейсе LayoutManager
Параметры:
name - строка, которая будет связана с компонентом
comp - добавляемый компонент

removeLayoutComponent

public void removeLayoutComponent(Component comp)
Удаляет указанный компонент из макета. Если карта была видимой поверх, отображается следующая карта под ней.
Задано:
removeLayoutComponent в интерфейсе LayoutManager
Параметры:
comp - удаляемый компонент.
См. также:
  • Container.remove(java.awt.Component)
  • Container.removeAll()

preferredLayoutSize

public Dimension preferredLayoutSize(Container parent)
Определяет предпочтительный размер аргумента контейнера, используя эту компоновку карт.
Задано:
preferredLayoutSize в интерфейсе LayoutManager
Параметры:
parent - родительский контейнер, в котором нужно выполнить компоновку
Возвращает:
предпочтительные размеры для компоновки подкомпонентов указанного контейнера
См. также:
  • Container.getPreferredSize()
  • minimumLayoutSize(java.awt.Container)

minimumLayoutSize

public Dimension minimumLayoutSize(Container parent)
Вычисляет минимальный размер для указанного панели.
Задано:
minimumLayoutSize в интерфейсе LayoutManager
Параметры:
parent - родительский контейнер, в котором нужно выполнить компоновку
Возвращает:
минимальные размеры, необходимые для компоновки подкомпонентов указанного контейнера
См. также:
  • Container.doLayout()
  • preferredLayoutSize(java.awt.Container)

maximumLayoutSize

public Dimension maximumLayoutSize(Container target)
Возвращает максимальные размеры для этой компоновки, учитывая компоненты в указанном целевом контейнере.
Задано:
maximumLayoutSize в интерфейсе LayoutManager2
Параметры:
target - компонент, который нужно компоновать
Возвращает:
максимальный размер контейнера
См. также:
  • Container
  • minimumLayoutSize(java.awt.Container)
  • preferredLayoutSize(java.awt.Container)

getLayoutAlignmentX

public float getLayoutAlignmentX(Container parent)
Возвращает выравнивание по оси X. Это определяет, как компонент хочет быть выровнен относительно других компонентов. Значение должно быть числом от 0 до 1, где 0 соответствует выравниванию по началу, 1 — выравниванию по краю, наиболее удалённому от начала, 0,5 — центрирование и т. д.
Задано:
getLayoutAlignmentX в интерфейсе LayoutManager2
Параметры:
parent - целевой контейнер
Возвращает:
предпочтение выравнивания по оси X

getLayoutAlignmentY

public float getLayoutAlignmentY(Container parent)
Возвращает выравнивание по оси Y. Это определяет, как компонент хочет быть выровнен относительно других компонентов. Значение должно быть числом от 0 до 1, где 0 соответствует выравниванию по началу, 1 — выравниванию по краю, наиболее удалённому от начала, 0,5 — центрирование и т. д.
Задано:
getLayoutAlignmentY в интерфейсе LayoutManager2
Параметры:
parent - целевой контейнер
Возвращает:
предпочтение выравнивания по оси Y

invalidateLayout

public void invalidateLayout(Container target)
Делает макет недействительным, указывая, что если компоновщик макета кэшировал информацию, он должен её выбросить.
Задано:
invalidateLayout в интерфейсе LayoutManager2
Параметры:
target - целевой контейнер

layoutContainer

public void layoutContainer(Container parent)
Компонует указанный контейнер, используя эту компоновку карт.

Каждый компонент в контейнере parent перестраивается, чтобы занимать размер контейнера, минус отступы, горизонтальные и вертикальные отступы.

Задано:
layoutContainer в интерфейсе LayoutManager
Параметры:
parent - родительский контейнер, в котором нужно выполнить компоновку
См. также:
  • Container.doLayout()

first

public void first(Container parent)
Переключается на первую карту контейнера.
Параметры:
parent - родительский контейнер, в котором нужно выполнить компоновку
См. также:
  • last(java.awt.Container)

next

public void next(Container parent)
Переключается на следующую карту указанного контейнера. Если текущая видимая карта является последней, этот метод переключается на первую карту в компоновке.
Параметры:
parent - родительский контейнер, в котором нужно выполнить компоновку
См. также:
  • previous(java.awt.Container)
END_OF_DOCUMENT_MARKER

предыдущий

public void previous(Container parent)
Переключается на предыдущую карту указанного контейнера. Если текущая видимая карта является первой, этот метод переключается на последнюю карту в макете.
Параметры:
parent - родительский контейнер, в котором выполняется макетирование
См. также:
  • next(java.awt.Container)

последний

public void last(Container parent)
Переключается на последнюю карту контейнера.
Параметры:
parent - родительский контейнер, в котором выполняется макетирование
См. также:
  • first(java.awt.Container)

показать

public void show(Container parent, String name)
Переключается на компонент, добавленный в этот макет с указанным name, используя addLayoutComponent. Если такого компонента нет, то ничего не происходит.
Параметры:
parent - родительский контейнер, в котором выполняется макетирование
name - имя компонента
См. также:
  • addLayoutComponent(java.awt.Component, java.lang.Object)

toString

public String toString()
Возвращает строковое представление состояния этого макета карт.
Переопределяет:
toString в классе Object
Возвращает:
строковое представление этого макета карт.

© 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/CardLayout.html

Spec-Zone.ru

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