Класс CardLayout

public class CardLayout
extends Object
implements LayoutManager2, Serializable

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

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

Конструкторы

CardLayout

public CardLayout()

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

CardLayout

public CardLayout(int hgap,
                  int vgap)

Создаёт новую компоновку карточек с заданными горизонтальными и вертикальными отступами. Горизонтальные отступы размещаются по левому и правому краям. Вертикальные отступы размещаются по верхнему и нижнему краям.

Параметры:

hgap - горизонтальный отступ.

vgap - вертикальный отступ.

Методы

getHgap

public int getHgap()

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

Возвращает:

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

С:

JDK1.1

См. также:

setHgap(int), getVgap()

setHgap

public void setHgap(int hgap)

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

Параметры:

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

С:

JDK1.1

См. также:

getHgap(), setVgap(int)

getVgap

public int getVgap()

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

Возвращает:

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

См. также:

setVgap(int), getHgap()

setVgap

public void setVgap(int vgap)

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

Параметры:

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

С:

JDK1.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

getLayoutAlignmentY

public float getLayoutAlignmentY(Container parent)

Возвращает выравнивание по оси y. Это определяет, как компонент хочет выровняться относительно других компонентов. Значение должно быть числом от 0 до 1, где 0 соответствует выравниванию по началу, 1 — выравниванию по концу, 0,5 — центрирование и т. д.

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

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

invalidateLayout

public void invalidateLayout(Container target)

Делает компоновку недействительной, указывая, что если компоновщик кэшировал информацию, он должен её отбросить.

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

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

layoutContainer

public void layoutContainer(Container 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

Возвращает:

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