Spec-Zone.ru › OpenJDK 17

Класс 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
См. также:
  • 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)

Предыдущий

public void previous(Container parent)
Переключается на предыдущую карту указанного контейнера. Если текущая видимая карта — первая, этот метод переключается на последнюю карту в макете.
Параметры:
parent - родительский контейнер, в котором нужно выполнить макет
См. также:
  • next(java.awt.Container)

Последний

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

показать

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API