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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарел, будет удален: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного интервала реального времени.

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

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.