模块  java.desktop
软件包  java.awt

Class CardLayout

  • 实现的所有接口
    LayoutManager ， LayoutManager2 ， Serializable 
    public class CardLayoutextends Objectimplements 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

        @Deprecatedpublic 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.