Класс 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

См. также:

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

Конструктор	Описание
`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

public void setHgap(int hgap)

Устанавливает горизонтальный зазор между компонентами.

Параметры:

hgap - горизонтальный зазор между компонентами.

С:

1.1

См. также:

getVgap

public int getVgap()

Возвращает вертикальный зазор между компонентами.

Возвращает:

вертикальный зазор между компонентами.

См. также:

setVgap

public void setVgap(int vgap)

Устанавливает вертикальный зазор между компонентами.

Параметры:

vgap - вертикальный зазор между компонентами.

С:

1.1

См. также:

addLayoutComponent

public void addLayoutComponent(Component comp, Object constraints)

Добавляет указанный компонент в внутреннюю таблицу имён компоновки карт. Объект, указанный в constraints, должен быть строкой. Компоновка карт хранит эту строку как пару ключ-значение, которая может использоваться для произвольного доступа к конкретной карте. Вызывая метод show, приложение может отобразить компонент с указанным именем.

Определено в:

addLayoutComponent в интерфейсе LayoutManager2

Параметры:

comp - добавляемый компонент.

constraints - метка, идентифицирующая конкретную карту в компоновке.

Исключения:

IllegalArgumentException - если ограничение не является строкой.

См. также:

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 - удаляемый компонент.

См. также:

preferredLayoutSize

public Dimension preferredLayoutSize(Container parent)

Определяет предпочтительный размер контейнера-аргумента, используя эту компоновку карт.

Определено в:

preferredLayoutSize в интерфейсе LayoutManager

Параметры:

parent - родительский контейнер, для которого необходимо выполнить компоновку

Возвращает:

предпочтительные размеры для компоновки подкомпонентов указанного контейнера

См. также:

minimumLayoutSize

public Dimension minimumLayoutSize(Container parent)

Вычисляет минимальный размер для указанной панели.

Определено в:

minimumLayoutSize в интерфейсе LayoutManager

Параметры:

parent - родительский контейнер, для которого необходимо выполнить компоновку

Возвращает:

минимальные размеры, необходимые для компоновки подкомпонентов указанного контейнера

См. также:

maximumLayoutSize

public Dimension maximumLayoutSize(Container target)

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

Определено в:

maximumLayoutSize в интерфейсе LayoutManager2

Параметры:

target - компонент, который нужно расположить

Возвращает:

максимальный размер контейнера

См. также:

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 - родительский контейнер, для которого нужно выполнить компоновку

См. также:

first

public void first(Container parent)

Переключается на первую карту контейнера.

Параметры:

parent - родительский контейнер, для которого нужно выполнить компоновку

См. также:

public void next(Container parent)

Переходит к следующей карте указанного контейнера. Если текущая видимая карта является последней, этот метод переходит к первой карте в макете.

Parameters:

parent - родительский контейнер, в котором необходимо выполнить макетирование

See Also:

public void previous(Container parent)

Переходит к предыдущей карте указанного контейнера. Если текущая видимая карта является первой, этот метод переходит к последней карте в макете.

Parameters:

parent - родительский контейнер, в котором необходимо выполнить макетирование

See Also:

last

public void last(Container parent)

Переходит к последней карте контейнера.

Parameters:

parent - родительский контейнер, в котором необходимо выполнить макетирование

See Also:

show

public void show(Container parent, String name)

Переходит к компоненту, добавленному в этот макет с указанным name, используя addLayoutComponent. Если такого компонента не существует, ничего не происходит.

Parameters:

parent - родительский контейнер, в котором необходимо выполнить макетирование

name - имя компонента

See Also:

toString

public String toString()

Возвращает строковое представление состояния макета карт.

Overrides:: toString в классе Object
Returns:: строковое представление этого макета карт.

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