如何使用 CardLayout

原文： https://docs.oracle.com/javase/tutorial/uiswing/layout/card.html

Note: This lesson covers writing layout code by hand, which can be challenging. If you are not interested in learning all the details of layout management, you might prefer to use the GroupLayout layout manager combined with a builder tool to lay out your GUI. One such builder tool is the NetBeans IDE. Otherwise, if you want to code by hand and do not want to use GroupLayout, then GridBagLayout is recommended as the next most flexible and powerful layout manager.

如果您对使用 JavaFX 创建 GUI 感兴趣，请参阅在 JavaFX 中使用布局。

下图表示使用 CardLayout 类在两个面板之间切换的应用程序的快照。

单击“启动”按钮以使用 Java™Web Start （下载 Java SE ）运行 CardLayoutDemo。或者，要自己编译并运行示例，请参考示例索引。

该演示的完整代码位于 CardLayoutDemo.java 文件中。

CardLayout类管理共享相同显示空间的两个或多个组件（通常是JPanel实例）。使用CardLayout类时，让用户使用组合框在组件之间进行选择。 CardLayoutDemo应用程序是用于说明此功能的示例。

完成相同任务的另一种方法是使用选项卡式窗格。下图显示了上一个示例的选项卡式窗格版本：

由于选项卡式窗格提供了自己的 GUI，因此使用选项卡式窗格比使用CardLayout类更简单。例如，使用选项卡式窗格实现前面的示例会导致程序包含更少的代码行。

单击“启动”按钮以使用 Java™Web Start （下载 JDK 7 或更高版本）运行 TabDemo。或者，要自己编译并运行示例，请参考示例索引。

该演示的完整代码位于 TabDemo.java 文件中。

从概念上讲，CardLayout管理的每个组件就像一个堆叠中的扑克牌或交易卡，其中只有顶部卡片随时可见。您可以选择以下列任何一种方式显示的卡片：

• 通过要求第一张或最后一张卡，按顺序将其添加到容器中
• 通过向后或向前翻转甲板
• 通过指定具有特定名称的卡

CardLayoutDemo类使用最后一个方案。

CardLayoutDemo.java 应用程序的以下代码片段创建CardLayout对象及其管理的组件。

//Where instance variables are declared:
JPanel cards;
final static String BUTTONPANEL = "Card with JButtons";
final static String TEXTPANEL = "Card with JTextField";
//Where the components controlled by the CardLayout are initialized:
//Create the "cards".
JPanel card1 = new JPanel();
...
JPanel card2 = new JPanel();
...
//Create the panel that contains the "cards".
cards = new JPanel(new CardLayout());
cards.add(card1, BUTTONPANEL);
cards.add(card2, TEXTPANEL);

要将组件添加到CardLayout对象管理的容器，请指定标识要添加的组件的字符串。例如，在此演示中，第一个面板具有字符串"Card with JButtons"，第二个面板具有字符串"Card with JTextField"。在此演示中，这些字符串也在组合框中使用。

要选择CardLayout对象显示的组件，请在代码示例中添加其他代码：

//Where the GUI is assembled:
//Put the JComboBox in a JPanel to get a nicer look.
JPanel comboBoxPane = new JPanel(); //use FlowLayout
String comboBoxItems[] = { BUTTONPANEL, TEXTPANEL };
JComboBox cb = new JComboBox(comboBoxItems);
cb.setEditable(false);
cb.addItemListener(this);
comboBoxPane.add(cb);
...
pane.add(comboBoxPane, BorderLayout.PAGE_START);
pane.add(cards, BorderLayout.CENTER);
...
//Method came from the ItemListener class implementation,
//contains functionality to process the combo box item selecting
public void itemStateChanged(ItemEvent evt) {
    CardLayout cl = (CardLayout)(cards.getLayout());
    cl.show(cards, (String)evt.getItem());
}

此示例显示要使用CardLayout类的show方法，必须设置当前可见的组件。 show方法中的第一个参数是CardLayout控制的容器 - 即CardLayout管理的组件的容器。第二个参数是标识要显示的组件的字符串。此字符串与将组件添加到容器时使用的字符串相同。

下表列出了用于选择组件的CardLayout类方法。对于每个方法，第一个参数是CardLayout是布局管理器的容器（CardLayout控制的卡的容器）。

此路径中只有一个示例使用CardLayout，这是 CardLayoutDemo 。通常，我们的示例使用选项卡式窗格而不是CardLayout，因为选项卡式窗格提供了自己的 GUI。