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

previous

public void previous(Container parent)

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

Параметры:
parent - родительский контейнер, в котором нужно выполнить макет
См. также:
next(java.awt.Container)

last

public void last(Container parent)

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

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

show

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, 2020, 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/11/docs/api/java.desktop/java/awt/CardLayout.html

Spec-Zone .ru
спецификации, руководства, описания, API