java.awt
類別 CardLayout

java.lang.Object
  java.awt.CardLayout

所有已實作的介面：

LayoutManager, LayoutManager2, Serializable

public class CardLayout
extends Object
implements LayoutManager2, Serializable

CardLayout 物件是容器的佈局管理器。它將容器中的每個元件看作一張卡片。一次只能看到一張卡片，容器則充當卡片的堆疊(stack)空間。當容器第一次顯示時，第一個添加到 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

返回：

此卡片佈局的字元串表示形式。