Module  java.desktop
软件包  java.awt

Class CardLayout

  • All Implemented Interfaces:
    LayoutManager ， LayoutManager2 ， Serializable 

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

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

    从以下版本开始：
    1.0
    另请参见：
    Container ， Serialized 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)
        已过时。 替换为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
        结果
        该卡片布局的字符串表示形式。