类 java.awt.CardLayout

java.lang.Object
   |
   +----java.awt.CardLayout

public class CardLayout

extends Object

implements LayoutManager2, Serializable

CardLayout 对象是容器的布局管理器。它将容器中的每个组件当作一个卡片来处理。在某一时间，只有一个卡片是可见的，容器象一个卡片堆栈一样工作。

卡片次序是根据容器的组件对象的内部次序来确定的。 CardLayout 定义了一系列方法，来允许一个应用顺序地翻动这些卡片，或显示一个指定的卡片。为对卡片进行快速的随机存取，可使用 addLayoutComponent 方法将字符串标识符与给定的卡片连接起来。

来自：

JDK1.0

参见：

Container

构造子索引

CardLayout()

创建一个新的卡片布局，其间距为 0 。

CardLayout(int, int)

用指定的水平间距和垂直间距创建一个新的卡片布局。

方法索引

addLayoutComponent(Component, Object)

将指定的组件添加到该卡片布局内部的名字表中。

addLayoutComponent(String, Component)

不推荐使用该方法。

first(Container)

翻到容器的第一张卡片。

getHgap()

获取两个组件之间的水平间距。

getLayoutAlignmentX(Container)

返回沿 X 轴 的对齐方式。

getLayoutAlignmentY(Container)

返回沿 Y 轴 的对齐方式。

getVgap()

获取两个组件之间的垂直间距。

invalidateLayout(Container)

该方法使布局无效，表示若布局管理器具有存贮信息，则它应被删除。

last(Container)

翻到容器的最后一张卡片。

layoutContainer(Container)

使用这个卡片布局对指定的容器进行布局。

maximumLayoutSize(Container)

返回该布局给出的指定目标容器中组件的最大尺寸。

minimumLayoutSize(Container)

计算指定的面板的最小尺寸。

next(Container)

翻到指定容器的下一张卡片。

preferredLayoutSize(Container)

使用该卡片的布局确定容器参数的最佳尺寸。

previous(Container)

翻到指定容器的前一张卡片。

removeLayoutComponent(Component)

从布局中删除特定组件。

setHgap(int)

设置两个组件之间的水平间距。

setVgap(int)

设置两个组件之间的垂直间距。

show(Container, String)

翻到使用 addLayoutComponent 方法，用指定的 名字添加到该布局中的组件。

toString()

返回该卡片布局的状态的字符串表示。

构造子

 public CardLayout()

创建一个新的卡片布局，其间距为 0 。

 public CardLayout(int hgap,
                   int vgap)

用指定的水平间距和垂直间距创建一个新的卡片布局。水平间距位于左边沿和右边沿上。垂直间距位于上边沿和下边沿上。

参数：

hgap - 水平间距。

vgap - 垂直间距。

方法

 public int getHgap()

获取两个组件之间的水平间距。

返回值：

两个组件之间的水平间距。

参见：

setHgap, getVgap

 public void setHgap(int hgap)

设置两个组件之间的水平间距。

参数：

hgap - 两个组件之间的水平间距。

参见：

getHgap, setVgap

 public int getVgap()

获取两个组件之间的垂直间距。

返回值：

两个组件之间的垂直间距。

参见：

setVgap, getHgap

 public void setVgap(int vgap)

设置两个组件之间的垂直间距。

参数：

vgap - 两个组件之间的垂直间距。

参见：

getVgap, setHgap

 public void addLayoutComponent(Component comp,
                 Object constraints)

将指定的组件添加到该卡片布局内部的名字表中。由 constraints 指定的对象必须是一个字符串。卡片布局将该字符串存储成一个“键-值”对，用于随机存取一个特定卡片。通过调用 show 方法，一个应用可用指定的名字显示组件。

参数：

comp - 要添加的组件。

constraints - 标识布局中特定卡片的标签。

抛出： IllegalArgumentException

若约束条件不是一个字符串。

参见：

show

 public void addLayoutComponent(String name,
                                Component comp)

注意：不推荐使用 addLayoutComponent() 方法。 用 addLayoutComponent(Component, Object) 方法替换。.

 public void removeLayoutComponent(Component comp)

从布局中删除指定的组件。

参数：

comp - 要删除的组件。

参见：

remove, removeAll

 public Dimension preferredLayoutSize(Container parent)

使用该卡片的布局确定容器参数的最佳尺寸。

参数：

parent - 父代容器的名字。

返回值：

对指定容器的子组件进行布局的最佳尺寸。

参见：

getPreferredSize, minimumLayoutSize

 public Dimension minimumLayoutSize(Container parent)

计算指定的面板的最小尺寸。

参数：

parent - 进行布局的父代容器的名字。

返回值：

对指定容器的子组件进行布局所需的最小尺寸。

参见：

doLayout, preferredLayoutSize

 public Dimension maximumLayoutSize(Container target)

返回该布局给出的指定目标容器中组件的最大尺寸。

参数：

target - 要布局的组件

参见：

Container, minimumLayoutSize, preferredLayoutSize

 public float getLayoutAlignmentX(Container parent)

返回沿 X 轴 的对齐方式。它指定了该组件相对于其它组件的对齐方式。该值应是一个介于 0 和 1 之间的数，其中 0 表示按原点对齐，1 表示按距原点最远的点对齐，0.5 表示居中对齐等。

 public float getLayoutAlignmentY(Container parent)

返回沿 Y 轴 的对齐方式。它指定了该组件相对于其它组件的对齐方式。该值应是一个介于 0 和 1 之间的数，其中 0 表示按原点对齐，1 表示按距原点最远的点对齐，0.5 表示居中对齐等。

 public void invalidateLayout(Container target)

该方法使布局无效，表示若布局管理器具有存储信息，则它应被删除。

 public void layoutContainer(Container parent)

使用这个卡片布局对指定的容器进行布局。

调整 parent 容器中的每个组件形状，使其与减去周围边框，水平间距和垂直间距的空间的容器尺寸一致。

参数：

parent - 进行布局的父代容器的名字。

参见：

doLayout

 public void first(Container parent)

翻到容器的第一张卡片。

参数：

parent - 进行布局的父代容器的名字。

参见：

last

 public void next(Container parent)

翻到指定容器的下一张卡片。若当前可见的卡片是最后一张卡片，则翻到布局中的第一张卡片。

参数：

parent - 进行布局的父容器的名字。

参见：

previous

 public void previous(Container parent)

翻到指定容器的前一张卡片。若当前可见的卡片是第一张卡片，则翻到布局中的最后一张卡片。

参数：

parent - 进行布局的父代容器的名字。

参见：

next

 public void last(Container parent)

翻到容器的最后一张卡片。

参数：

parent - 进行布局的父代容器的名字。

参见：

first

 public void show(Container parent,
                  String name)

翻到使用 addLayoutComponent 方法，用指定的 名字添加到该布局中的组件。若不存在这样的组件，则不执行任何操作。

参数：

parent - 进行布局的父代容器的名字。

name - 组件的名字。

参见：

addLayoutComponent

 public String toString()

返回该卡片布局的状态的字符串表示。

返回值：

该卡片布局的字符串表示。

覆盖：

类 Object 中的 toString