模块 java.desktop
包 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) 方法可用于将字符串标识符与给定卡相关联，以实现快速随机访问。

自从：
1.0
参见：

  • 构造方法详细信息

    • CardLayout

      public CardLayout()
      创建一个新的卡片布局，间隙大小为零。

    • CardLayout

      public CardLayout(int hgap, int vgap)
      创建具有指定水平和垂直间距的新卡片布局。水平间隙位于左右边缘。垂直间隙位于顶部和底部边缘。
      参数：
      hgap - 水平间隙。
      vgap - 垂直间隙。

  • 方法详情

    • getHgap

      public int getHgap()
      获取组件之间的水平间距。
      返回：
      组件之间的水平间隙。
      自从：
      1.1
      参见：

    • setHgap

      public void setHgap(int hgap)
      设置组件之间的水平间距。
      参数：
      hgap - 组件之间的水平间隙。
      自从：
      1.1
      参见：

    • getVgap

      public int getVgap()
      获取组件之间的垂直间距。
      返回：
      组件之间的垂直间隙。
      参见：

    • setVgap

      public void setVgap(int vgap)
      设置组件之间的垂直间隙。
      参数：
      vgap - 组件之间的垂直间隙。
      自从：
      1.1
      参见：

    • addLayoutComponent

      public void addLayoutComponent(Component  comp, Object  constraints)
      将指定的组件添加到此卡片布局的内部名称表中。 constraints 指定的对象必须是字符串。卡片布局将此字符串存储为可用于随机访问特定卡片的键值对。通过调用show方法，应用程序可以显示具有指定名称的组件。
      指定者：
      addLayoutComponent 在接口 LayoutManager2 中
      参数：
      comp - 要添加的组件。
      constraints - 标识布局中特定卡片的标签。
      抛出：
      IllegalArgumentException - 如果约束不是字符串。
      参见：

    • addLayoutComponent

      @Deprecated public void addLayoutComponent(String  name, Component  comp)
      已弃用。
      替换为 addLayoutComponent(Component, Object) 。
      从接口 LayoutManager 复制的描述
      如果布局管理器使用每个组件字符串，则将组件 comp 添加到布局中，将其与 name 指定的字符串相关联。
      指定者：
      addLayoutComponent 在接口 LayoutManager 中
      参数：
      name - 要与组件关联的字符串
      comp - 要添加的组件

    • removeLayoutComponent

      public void removeLayoutComponent(Component  comp)
      从布局中移除指定的组件。如果卡片在顶部可见，则显示其下方的下一张卡片。
      指定者：
      removeLayoutComponent 在接口 LayoutManager 中
      参数：
      comp - 要删除的组件。
      参见：

    • preferredLayoutSize

      public Dimension  preferredLayoutSize(Container  parent)
      使用此卡片布局确定容器参数的首选大小。
      指定者：
      preferredLayoutSize 在接口 LayoutManager 中
      参数：
      parent - 进行布局的父容器
      返回：
      用于布置指定容器的子组件的首选尺寸
      参见：

    • minimumLayoutSize

      public Dimension  minimumLayoutSize(Container  parent)
      计算指定面板的最小尺寸。
      指定者：
      minimumLayoutSize 在接口 LayoutManager 中
      参数：
      parent - 进行布局的父容器
      返回：
      布置指定容器的子组件所需的最小尺寸
      参见：

    • maximumLayoutSize

      public Dimension  maximumLayoutSize(Container  target)
      给定指定目标容器中的组件，返回此布局的最大尺寸。
      指定者：
      maximumLayoutSize 在接口 LayoutManager2 中
      参数：
      target - 需要布局的组件
      返回：
      容器的最大尺寸
      参见：

    • getLayoutAlignmentX

      public float getLayoutAlignmentX(Container  parent)
      返回沿 x 轴的对齐方式。这指定组件如何相对于其他组件对齐。该值应为 0 到 1 之间的数字，其中 0 表示沿原点对齐，1 表示离原点最远，0.5 表示居中，等等。
      指定者：
      getLayoutAlignmentX 在接口 LayoutManager2 中
      参数：
      parent - 目标容器
      返回：
      x 轴对齐首选项

    • getLayoutAlignmentY

      public float getLayoutAlignmentY(Container  parent)
      返回沿 y 轴的对齐方式。这指定组件如何相对于其他组件对齐。该值应为 0 到 1 之间的数字，其中 0 表示沿原点对齐，1 表示离原点最远，0.5 表示居中，等等。
      指定者：
      getLayoutAlignmentY 在接口 LayoutManager2 中
      参数：
      parent - 目标容器
      返回：
      y 轴对齐首选项

    • invalidateLayout

      public void invalidateLayout(Container  target)
      使布局无效，表示如果布局管理器缓存了信息，则应将其丢弃。
      指定者：
      invalidateLayout 在接口 LayoutManager2 中
      参数：
      target - 目标容器

    • layoutContainer

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

      parent 容器中的每个组件都被重塑为容器的大小，减去周围insets的空间、水平间隙和垂直间隙。

      指定者：
      layoutContainer 在接口 LayoutManager 中
      参数：
      parent - 进行布局的父容器
      参见：

    • first

      public void first(Container  parent)
      翻转到容器的第一张卡片。
      参数：
      parent - 进行布局的父容器
      参见：

    • next

      public void next(Container  parent)
      翻转到指定容器的下一张卡片。如果当前可见的卡片是最后一张，此方法将翻转到布局中的第一张卡片。
      参数：
      parent - 进行布局的父容器
      参见：

    • previous

      public void previous(Container  parent)
      翻到指定容器的上一张卡片。如果当前可见的卡片是第一张，此方法将翻转到布局中的最后一张卡片。
      参数：
      parent - 进行布局的父容器
      参见：

    • last

      public void last(Container  parent)
      翻到容器的最后一张卡片。
      参数：
      parent - 进行布局的父容器
      参见：

    • show

      public void show(Container  parent, String  name)
      使用 addLayoutComponent 翻转到使用指定 name 添加到此布局的组件。如果不存在这样的组件，则什么也不会发生。
      参数：
      parent - 进行布局的父容器
      name - 组件名称
      参见：

    • toString

      public String  toString()
      返回此卡片布局状态的字符串表示形式。
      重写：
      toString 在类 Object 中
      返回：
      此卡片布局的字符串表示形式。