CardLayout (Java Platform SE 7)

java.lang.Object
- java.awt.CardLayout

すべての実装されたインタフェース:

LayoutManager, LayoutManager2, Serializable
```
public class CardLayout
extends Object
implements LayoutManager2, Serializable
```
CardLayout オブジェクトは、コンテナのレイアウトマネージャーです。コンテナ内の各コンポーネントをカードとして扱います。一度に 1 枚のカードだけを表示し、コンテナはカードのスタックとして動作します。CardLayout オブジェクトに最初に追加されるコンポーネントは、コンテナが最初に表示されるときの可視コンポーネントになります。
カードの順序は、コンポーネントオブジェクトのコンテナ自身の内部順序で決まります。CardLayout は、アプリケーションがこれらのカードを順番にめくったり、指定したカードを表示したりできるようにするメソッドのセットを定義します。addLayoutComponent(java.awt.Component, java.lang.Object) メソッドを使用すると、高速なランダムアクセスのために、文字列の識別子を指定したカードに関連付けることができます。

導入されたバージョン:

JDK1.0

関連項目:
Container, 直列化された形式

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`CardLayout()` 新しいカードレイアウトをサイズゼロの間隔で作成します。
`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()
```
    新しいカードレイアウトをサイズゼロの間隔で作成します。
  - 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 メソッドを呼び出すことにより、アプリケーションは指定された名前でコンポーネントを表示できます。
    
    定義:
    
    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 によって指定された文字列に関連付けます。
    
    定義:
    
    addLayoutComponent、インタフェース: LayoutManager
    
    パラメータ:
    name - コンポーネントに関連付けられる文字列
    comp - 追加されるコンポーネント
  - removeLayoutComponent
```
public void removeLayoutComponent(Component comp)
```
    指定されたコンポーネントをレイアウトから削除します。カードが最前面に表示されていた場合は、その下にある次のカードが表示されます。
    
    定義:
    
    removeLayoutComponent、インタフェース: LayoutManager
    
    パラメータ:
    comp - 削除されるコンポーネント。
    関連項目:
    Container.remove(java.awt.Component), Container.removeAll()
  - preferredLayoutSize
```
public Dimension preferredLayoutSize(Container parent)
```
    このカードレイアウトを使用して、引数のコンテナの推奨サイズを判定します。
    
    定義:
    
    preferredLayoutSize、インタフェース: LayoutManager
    
    パラメータ:
    parent - レイアウトが行われる親コンテナ
    
    戻り値:
    指定されたコンテナのサブコンポーネントを配置するための望ましい寸法
    関連項目:
    Container.getPreferredSize(), minimumLayoutSize(java.awt.Container)
  - minimumLayoutSize
```
public Dimension minimumLayoutSize(Container parent)
```
    指定されたパネルの最小サイズを算出します。
    
    定義:
    
    minimumLayoutSize、インタフェース: LayoutManager
    
    パラメータ:
    parent - レイアウトが行われる親コンテナ
    
    戻り値:
    指定されたコンテナのサブコンポーネントを配置するための最小の寸法
    関連項目:
    Container.doLayout(), preferredLayoutSize(java.awt.Container)
  - maximumLayoutSize
```
public Dimension maximumLayoutSize(Container target)
```
    指定されたターゲットコンテナにコンポーネントが与えられた場合の、レイアウトの最大サイズを返します。
    
    定義:
    
    maximumLayoutSize、インタフェース: LayoutManager2
    
    パラメータ:
    target - レイアウトが必要なコンポーネント
    関連項目:
    Container, minimumLayoutSize(java.awt.Container), preferredLayoutSize(java.awt.Container)
  - getLayoutAlignmentX
```
public float getLayoutAlignmentX(Container parent)
```
    x 軸方向の配置を返します。これは、そのコンポーネントがほかのコンポーネントに対してどのように配置されるべきかを指定したものです。この値は 0 から 1 の間の数値で、0 は原点に沿った配置を表し、1 は原点からもっとも遠いところに、0.5 は中央に配置されます。
    
    定義:
    
    getLayoutAlignmentX、インタフェース: LayoutManager2
  - getLayoutAlignmentY
```
public float getLayoutAlignmentY(Container parent)
```
    y 軸方向の配置を返します。これは、そのコンポーネントがほかのコンポーネントに対してどのように配置されるべきかを指定したものです。この値は 0 から 1 の間の数値で、0 は原点に沿った配置を表し、1 は原点からもっとも遠いところに、0.5 は中央に配置されます。
    
    定義:
    
    getLayoutAlignmentY、インタフェース: LayoutManager2
  - invalidateLayout
```
public void invalidateLayout(Container target)
```
    レイアウトを無効にします。このとき、レイアウトマネージャーが情報をキャッシュしていればそれを破棄します。
    
    定義:
    
    invalidateLayout、インタフェース: LayoutManager2
  - layoutContainer
```
public void layoutContainer(Container parent)
```
    このカードレイアウトを使用して、指定されたコンテナを配置します。
    parent コンテナの各コンポーネントは、コンテナから周囲のインセット、水平方向の間隔、および垂直方向の間隔のスペースを差し引いたサイズになるように形状変更されます。
    
    定義:
    
    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)
  - show
```
public void show(Container parent,
        String name)
```
    addLayoutComponent を使用して、指定された name でこのレイアウトに追加されたコンポーネントに切り替えます。そのようなコンポーネントがない場合、処理は行われません。
    
    パラメータ:
    parent - レイアウトが行われる親コンテナ
    name - コンポーネントの名前
    関連項目:
    addLayoutComponent(java.awt.Component, java.lang.Object)
  - toString
```
public String toString()
```
    このカードレイアウトの状態を示す文字列表現を返します。
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    このカードレイアウトの文字列表現

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス CardLayout

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

CardLayout

CardLayout

メソッドの詳細

getHgap

setHgap

getVgap

setVgap

addLayoutComponent

addLayoutComponent

removeLayoutComponent

preferredLayoutSize

minimumLayoutSize

maximumLayoutSize

getLayoutAlignmentX

getLayoutAlignmentY

invalidateLayout

layoutContainer

first

next

previous

last

show

toString