Класс CardLayout

java.lang.Object

java.awt.CardLayout

Все реализуемые интерфейсы:: LayoutManager, LayoutManager2, Serializable

public class CardLayout extends Object implements LayoutManager2, Serializable

Объект CardLayout — это менеджер компоновки контейнера. Он рассматривает каждый компонент в контейнере как карточку. Одновременно видна только одна карточка, а контейнер действует как стопка карточек. Первый компонент, добавленный в объект CardLayout, становится видимым при первом отображении контейнера.

Порядок карточек определяется внутренним порядком объектов-компонентов самого контейнера. CardLayout определяет набор методов, позволяющих приложению последовательно переключаться между этими карточками или отображать указанную карточку. Метод addLayoutComponent(Component, 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()`	Возвращает строковое представление состояния этой компоновки карточек.

Методы, объявленные в классе 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)

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

Параметры:

parent — родительский контейнер, в котором выполняется компоновка

См. также:

public void previous(Container parent)

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

Параметры:

parent — родительский контейнер, в котором выполняется компоновка

См. также:

last

public void last(Container parent)

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

Параметры:

parent — родительский контейнер, в котором выполняется компоновка

См. также:

show

public void show(Container parent, String name)

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

Параметры:

parent — родительский контейнер, в котором выполняется компоновка

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

См. также:

toString

public String toString()

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

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этой компоновки карточек.

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