JavaTM Platform
Standard Ed. 6

java.awt
类 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) 方法可用于将一个字符串标识符与给定卡片关联,以便进行快速随机访问。

从以下版本开始:
JDK1.0
另请参见:
Container, 序列化表格

构造方法摘要
CardLayout()
          创建一个间距大小为 0 的新卡片布局。
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)
          翻转到使用 addLayoutComponent 添加到此布局的具有指定 name 的组件。
 String toString()
          返回此卡片布局状态的字符串表示形式。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

CardLayout

public CardLayout()
创建一个间距大小为 0 的新卡片布局。


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 方法,应用程序可以显示具有指定名称的组件。

指定者:
接口 LayoutManager2 中的 addLayoutComponent
参数:
comp - 要添加的组件。
constraints - 标识布局中特定卡片的标记。
抛出:
IllegalArgumentException - 如果 constraint 不是一个字符串。
另请参见:
show(java.awt.Container, java.lang.String)

addLayoutComponent

@Deprecated
public void addLayoutComponent(String name,
                                          Component comp)
已过时。 addLayoutComponent(Component, Object) 取代。

从接口 LayoutManager 复制的描述
如果布局管理器使用每组件字符串,则将组件 comp 添加到布局,并将它与 name 指定的字符串关联。

指定者:
接口 LayoutManager 中的 addLayoutComponent
参数:
name - 要与组件关联的字符串
comp - 要添加的组件

removeLayoutComponent

public void removeLayoutComponent(Component comp)
从布局中移除指定的组件。如果顶部的卡片可见,则紧挨其下方的下一张卡片也将显示。

指定者:
接口 LayoutManager 中的 removeLayoutComponent
参数:
comp - 要移除的组件。
另请参见:
Container.remove(java.awt.Component), Container.removeAll()

preferredLayoutSize

public Dimension preferredLayoutSize(Container parent)
使用此卡片布局确定容器参数的首选大小。

指定者:
接口 LayoutManager 中的 preferredLayoutSize
参数:
parent - 要在其中进行布局的父容器
返回:
布置指定容器子组件的首选尺寸
另请参见:
Container.getPreferredSize(), minimumLayoutSize(java.awt.Container)

minimumLayoutSize

public Dimension minimumLayoutSize(Container parent)
计算指定面板大小的最小值。

指定者:
接口 LayoutManager 中的 minimumLayoutSize
参数:
parent - 要在其中进行布局的父容器
返回:
布置指定容器子组件所需的最小尺寸
另请参见:
Container.doLayout(), preferredLayoutSize(java.awt.Container)

maximumLayoutSize

public Dimension maximumLayoutSize(Container target)
给出指定目标容器中的组件,返回此布局的最大尺寸。

指定者:
接口 LayoutManager2 中的 maximumLayoutSize
参数:
target - 需要布局的组件
另请参见:
Container, minimumLayoutSize(java.awt.Container), preferredLayoutSize(java.awt.Container)

getLayoutAlignmentX

public float getLayoutAlignmentX(Container parent)
返回沿 x 轴的对齐方式。这指定了如何相对于其他组件来对齐该组件。返回值应该在 0 和 1 之间,其中 0 表示根据原点进行对齐,1 表示根据距离原点最远的点对齐,0.5 表示居中对齐等等。

指定者:
接口 LayoutManager2 中的 getLayoutAlignmentX

getLayoutAlignmentY

public float getLayoutAlignmentY(Container parent)
返回沿 y 轴的对齐方式。这指定了如何相对于其他组件来对齐该组件。返回值应该在 0 和 1 之间,其中 0 表示根据原点进行对齐,1 表示根据距离原点最远的点对齐,0.5 表示居中对齐等等。

指定者:
接口 LayoutManager2 中的 getLayoutAlignmentY

invalidateLayout

public void invalidateLayout(Container target)
使布局无效,指示如果布局管理器缓存了信息,则应该将其丢弃。

指定者:
接口 LayoutManager2 中的 invalidateLayout

layoutContainer

public void layoutContainer(Container parent)
使用此卡片布局布置指定的容器。

parent 容器中每个组件的尺寸要变为容器尺寸减去组件四周 insets 的空间,再减去水平间距和垂直间距。

指定者:
接口 LayoutManager 中的 layoutContainer
参数:
parent - 要在其中进行布局的父容器
另请参见:
Container.doLayout()

first

public void first(Container parent)
翻转到容器的第一张卡片。

参数:
parent - 要在其中进行布局的父容器
另请参见:
last(java.awt.Container)

next

public void next(Container parent)
翻转到指定容器的下一张卡片。如果当前的可见卡片是最后一个,则此方法翻转到布局的第一张卡片。

参数:
parent - 要在其中进行布局的父容器
另请参见:
jjava.awt.CardLayout#previous

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)
翻转到使用 addLayoutComponent 添加到此布局的具有指定 name 的组件。如果不存在这样的组件,则不发生任何操作。

参数:
parent - 要在其中进行布局的父容器
name - 组件名称
另请参见:
addLayoutComponent(java.awt.Component, java.lang.Object)

toString

public String toString()
返回此卡片布局状态的字符串表示形式。

覆盖:
Object 中的 toString
返回:
此卡片布局的字符串表示形式。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策