模块  java.desktop
软件包  java.awt

Class CardLayout

  • 实现的所有接口
    LayoutManagerLayoutManager2Serializable

    public class CardLayout
    extends Object
    implements LayoutManager2, Serializable
    CardLayout对象是容器的布局管理器。 它将容器中的每个组件视为卡片。 一次只能看到一张卡片,而容器则充当一叠卡片。 添加到CardLayout对象的第一个组件是首次显示容器时的可见组件。

    卡的排序由容器自己的组件对象的内部排序决定。 CardLayout定义了一组方法,允许应用程序按顺序翻阅这些卡,或显示指定的卡。 addLayoutComponent(java.awt.Component, java.lang.Object)方法可用于将字符串标识符与给定卡相关联以进行快速随机访问。

    从以下版本开始:
    1.0
    另请参见:
    ContainerSerialized Form
    • 构造方法详细信息

      • 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方法,应用程序可以显示具有指定名称的组件。
        Specified by:
        addLayoutComponent在界面 LayoutManager2
        参数
        comp - 要添加的组件。
        constraints - 标识布局中特定卡的标记。
        异常
        IllegalArgumentException - 如果约束不是字符串。
        另请参见:
        show(java.awt.Container, java.lang.String)
      • addLayoutComponent

        @Deprecated
        public void addLayoutComponent​(String name,
                                       Component comp)
        Deprecated.
        replaced by addLayoutComponent(Component, Object).
        从界面复制的说明: LayoutManager
        如果布局管理器使用每个组件的字符串,请将组件 comp添加到布局中,并将其与 name指定的字符串相关联。
        Specified by:
        addLayoutComponent在界面 LayoutManager
        参数
        name - 与组件关联的字符串
        comp - 要添加的组件
      • getLayoutAlignmentX

        public float getLayoutAlignmentX​(Container parent)
        返回沿x轴的对齐方式。 这指定了组件相对于其他组件的对齐方式。 该值应为0到1之间的数字,其中0表示沿原点对齐,1表示距离原点最远,0.5表示居中等。
        Specified by:
        getLayoutAlignmentX在界面 LayoutManager2
        参数
        parent - 目标容器
        结果
        x轴对齐偏好
      • getLayoutAlignmentY

        public float getLayoutAlignmentY​(Container parent)
        返回沿y轴的对齐方式。 这指定了组件相对于其他组件的对齐方式。 该值应为0到1之间的数字,其中0表示沿原点对齐,1表示距离原点最远,0.5表示居中等。
        Specified by:
        getLayoutAlignmentY在界面 LayoutManager2
        参数
        parent - 目标容器
        结果
        y轴对齐偏好
      • invalidateLayout

        public void invalidateLayout​(Container target)
        使布局无效,表明如果布局管理器缓存了信息,则应将其丢弃。
        Specified by:
        invalidateLayout在界面 LayoutManager2
        参数
        target - 目标容器
      • layoutContainer

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

        parent容器中的每个组件都被重新整形为容器的大小,减去周围插入的空间,水平间隙和垂直间隙。

        Specified by:
        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)
      • toString

        public String toString()
        返回此卡布局状态的字符串表示形式。
        重写:
        toString在类 Object
        结果
        a string representation of this card layout.