java.awt

Class CardLayout

public class CardLayout extends Object implements LayoutManager2, Serializable

This class implements a card-based layout scheme. Each included component is treated as a card. Only one card can be shown at a time. This class includes methods for changing which card is shown.
Constructor Summary
CardLayout()
Initializes a new instance of CardLayout with horizontal and vertical gaps of 0.
CardLayout(int hgap, int vgap)
Create a new CardLayout object with the specified horizontal and vertical gaps.
Method Summary
voidaddLayoutComponent(Component comp, Object constraints)
Add a new component to the layout.
voidaddLayoutComponent(String name, Component comp)
Add a new component to the layout.
voidfirst(Container parent)
Cause the first component in the container to be displayed.
intgetHgap()
Return this layout manager's horizontal gap.
floatgetLayoutAlignmentX(Container parent)
Return this layout manager's x alignment.
floatgetLayoutAlignmentY(Container parent)
Returns this layout manager's y alignment.
intgetVgap()
Return this layout manager's vertical gap.
voidinvalidateLayout(Container target)
Invalidate this layout manager's state.
voidlast(Container parent)
Cause the last component in the container to be displayed.
voidlayoutContainer(Container parent)
Lays out the container.
DimensionmaximumLayoutSize(Container target)
Get the maximum layout size of the container.
DimensionminimumLayoutSize(Container target)
Get the minimum layout size of the container.
voidnext(Container parent)
Cause the next component in the container to be displayed.
DimensionpreferredLayoutSize(Container parent)
Get the preferred layout size of the container.
voidprevious(Container parent)
Cause the previous component in the container to be displayed.
voidremoveLayoutComponent(Component comp)
Remove the indicated component from this layout manager.
voidsetHgap(int hgap)
Set this layout manager's horizontal gap.
voidsetVgap(int vgap)
Set this layout manager's vertical gap.
voidshow(Container parent, String name)
Cause the named component to be shown.
StringtoString()
Returns a string representation of this layout manager.

Constructor Detail

CardLayout

public CardLayout()
Initializes a new instance of CardLayout with horizontal and vertical gaps of 0.

CardLayout

public CardLayout(int hgap, int vgap)
Create a new CardLayout object with the specified horizontal and vertical gaps.

Parameters: hgap The horizontal gap vgap The vertical gap

Method Detail

addLayoutComponent

public void addLayoutComponent(Component comp, Object constraints)
Add a new component to the layout. The constraint must be a string which is used to name the component. This string can later be used to refer to the particular component.

Parameters: comp The component to add constraints The name by which the component can later be called

Throws: IllegalArgumentException If `constraints' is not a String

addLayoutComponent

public void addLayoutComponent(String name, Component comp)

Deprecated: This method is deprecated in favor of addLayoutComponent(Component, Object).

Add a new component to the layout. The name can be used later to refer to the component.

Parameters: name The name by which the component can later be called comp The component to add

first

public void first(Container parent)
Cause the first component in the container to be displayed.

Parameters: parent The parent container, not null.

getHgap

public int getHgap()
Return this layout manager's horizontal gap.

Returns: the horizontal gap

getLayoutAlignmentX

public float getLayoutAlignmentX(Container parent)
Return this layout manager's x alignment. This method always returns Component.CENTER_ALIGNMENT.

Parameters: parent Container using this layout manager instance

Returns: the x-axis alignment

getLayoutAlignmentY

public float getLayoutAlignmentY(Container parent)
Returns this layout manager's y alignment. This method always returns Component.CENTER_ALIGNMENT.

Parameters: parent Container using this layout manager instance

Returns: the y-axis alignment

getVgap

public int getVgap()
Return this layout manager's vertical gap.

Returns: the vertical gap

invalidateLayout

public void invalidateLayout(Container target)
Invalidate this layout manager's state.

last

public void last(Container parent)
Cause the last component in the container to be displayed.

Parameters: parent The parent container, not null.

layoutContainer

public void layoutContainer(Container parent)
Lays out the container. This is done by resizing the child components to be the same size as the parent, less insets and gaps.

Parameters: parent The parent container.

maximumLayoutSize

public Dimension maximumLayoutSize(Container target)
Get the maximum layout size of the container.

Parameters: target The parent container

Returns: the maximum layout size

minimumLayoutSize

public Dimension minimumLayoutSize(Container target)
Get the minimum layout size of the container.

Parameters: target The parent container

Returns: the minimum layout size

next

public void next(Container parent)
Cause the next component in the container to be displayed. If this current card is the last one in the deck, the first component is displayed.

Parameters: parent The parent container, not null.

preferredLayoutSize

public Dimension preferredLayoutSize(Container parent)
Get the preferred layout size of the container.

Parameters: parent The parent container

Returns: the preferred layout size

previous

public void previous(Container parent)
Cause the previous component in the container to be displayed. If this current card is the first one in the deck, the last component is displayed.

Parameters: parent The parent container, not null.

removeLayoutComponent

public void removeLayoutComponent(Component comp)
Remove the indicated component from this layout manager.

Parameters: comp The component to remove

setHgap

public void setHgap(int hgap)
Set this layout manager's horizontal gap.

Parameters: hgap The new gap

setVgap

public void setVgap(int vgap)
Set this layout manager's vertical gap.

Parameters: vgap The new gap

show

public void show(Container parent, String name)
Cause the named component to be shown. If the component name is unknown or null, this method does nothing.

Parameters: parent The parent container, not null. name The name of the component to show

toString

public String toString()
Returns a string representation of this layout manager.

Returns: A string representation of this object.