CardLayout

Aus Byte-Welt Wiki
Version vom 28. April 2018, 13:39 Uhr von L-ectron-X (Diskussion | Beiträge) (Die fertige Beispiel-Applikation)
Zur Navigation springenZur Suche springen

Das CardLayout - Tutorial

...wird anhand eines einfachen Beispiels zeigen, wie einfach es ist, mit einem CardLayout GUI-Komponenten für schnelle Bildwechsel vorzubereiten.

Das CardLayout "stapelt", ähnlich einem Spielkartenstapel, Components hintereinander, wobei aber immer nur eine Component sichtbar ist. Dadurch lassen sich schnelle Wechsel zu anderen Teilen einer Benutzeroberfläche durchführen, oder Teile von Benutzeroberflächen blitzschnell austauschen.
Ein Standardeinsatzzweck ist z.B. der eines Wizards, bei dem schrittweise einzelne verschiedene Panels nach einer Benutzeraktion "nach vorne" geholt werden können.

Layout-Stategie

Das CardLayout sorgt dafür, dass alle hintereinander liegenden Container in der gleichen Größe angezeigt werden, um ein Springen durch Redimensionierung der GUI zu verhindern.
Werden also mehrere Container (bspw. JPanels) mit unterschiedlichen Dimensionen im CardLayout angelegt, so erhalten alle Container die Größe des größten Containers.

Die erste dem CardLayout hinzugefügte Komponente, ist die Komponente, die nach beim ersten Aufruf des CardLayouts angezeigt wird.
Alle als "Cards" organisierten Container sind außerdem in der Reihenfolge im CardLayout gespeichert, in der sie ihm hinzugefügt wurden. In dieser Reihenfolge können sie mit den Methoden next() und previous() von CardLayout durchlaufen werden. Mit first() und last() kann jeweils der erste bzw. letzte Container angezeigt werden.
Für den schnellen direkten Zugriff auf einen ganz bestimmten Container, können die Container mit einem Constraints-Objekt verknüpft werden, das den Container näher beschreibt und mit dem die genaue Identifizierung möglich wird. Oft wird hierfür ein String verwendet.

Beispiel

Schritt für Schritt

Bauen wir also Schritt für Schritt ein CardLayout auf.

Zunächst brauchen wir einen "Behälter" der die GUI-Komponenten aufnimmt, die "hintereinander liegen" sollen, der also unseren Kartenstapel repräsentiert. Dieser lässt sich recht einfach erzeugen:

CardLayout cl new CardLayout();
JPanel cardPanel = new JPanel(cl);

Unser Kartenstapel ist also ein JPanel, dem wir bereits den LayoutManager CardLayout zuweisen.

Und dann brauchen wir natürlich Karten, die wir in den Kartenstapel legen wollen. D. h. also GUI-Objekte (z.B. JPanels), die wir in diesen Behälter einfügen und sammeln, um sie später "durchzublättern" oder zu selektieren. Stellvertretend für ein solches Karte-Objekt, schreiben wir uns eine Klasse, die von JPanel erbt und ihr übergebene Farben zeichnet. Die Klasse sieht z.B. so aus:

import java.awt.*;
import javax.swing.*;

class ColorPanel extends JPanel {
   public ColorPanel(Color color) {
      setBackground(color);
      JLabel label = new JLabel(color.toString());
      label.setHorizontalAlignment(JLabel.CENTER);
      add(label);
   }

   @Override
   public Dimension getPreferredSize() {
      return new Dimension(400, 300);
   }
}

Von dieser Klasse können wir uns später einige Objekte (Karten) erstellen und unserem Behälter (Kartenstapel) hinzufügen. Die Farb-Panels möchten wir dann "durchblättern".

Erzeugen wir nun also einige Farb-Panels, die wir dem Kartenstapel hinzufügen.

cardPanel.add(new ColorPanel(Color.WHITE), "WEISS");
cardPanel.add(new ColorPanel(Color.RED), "ROT");
cardPanel.add(new ColorPanel(Color.BLUE), "BLAU");
cardPanel.add(new ColorPanel(Color.YELLOW), "GELB");
cardPanel.add(new ColorPanel(Color.BLACK), "SCHWARZ");
cardPanel.add(new ColorPanel(Color.GREEN), "GRÜN");

Die add()-Methode unseres Kartenstapels (JPanel) erwartet als erstes Argument die Component, die dem Kartenstapel hinzugefügt werden soll. Hier erzeugen wir entsprechend eine neue Instanz unseres ColorPanel, dem wir die gewünschte Farbe als Argument mit geben.

Als zweites Argument erwartet die add()-Methode aus Container ein Constraints-Objekt, das die hinzuzufügende Komponente unterscheidbar macht. Das kann ein beliebiger Objekttyp sein. Wir haben uns hier für einen String-Typ entschieden, der die hinzuzufügende Komponente etwas näher "beschreibt".

Gut. Zum "Durchblättern" unseres Kartenstapels können wir uns zwei JButtons erzeugen, die wir auf ein weiteres JPanel setzen.

JPanel buttonPanel = new JPanel();

JButton forwardButton = new JButton("Weiter");
forwardButton.addActionListener(new ActionListener() {
   public void actionPerformed(ActionEvent e) {
      //hier kommt noch die Ereignisbehandlung hinein
   }
});

JButton rearwardButton = new JButton("Zurück");
rearwardButton.addActionListener(new ActionListener() {
   public void actionPerformed(ActionEvent e) {
      //hier kommt noch die Ereignisbehandlung hinein
   }
});

Wenn wir bspw. das gelbe JPanel jederzeit anzeigen können wollen, fügen wir noch einen weiteren JButton ein:

JButton yellowButton = new JButton("Gelb!");
yellowButton.addActionListener(new ActionListener() {
  public void actionPerformed(ActionEvent e) {
     //hier kommt noch die Ereignisbehandlung hinein
  }
});

Zum Aufrufen eines ganz bestimmten JPanels, wird wie oben bereits angeschnitten, ein String als "Schlüsselwert" benutzt. Damit kann zu jeder Zeit ein ganz bestimmter Container angezeigt werden.
Wir kommen gleich noch dazu, wie der Code dazu aussieht.

Die JButtons werden nun noch dem ButtonPanel hinzugefügt:

buttonPanel.add(forwardButton);
buttonPanel.add(rearwardButton);
buttonPanel.add(yellowButton);

OK. Fehlt nur noch ein Fenster, um eine testbare Applikation zu erhalten.

Die fertige Beispiel-Applikation

Die Klasse baut unsere Anwendung aus den oben gezeigten Teilen zusammen und bietet eine main()-Methode zum Starten an. Diese Klasse sieht so aus:

import java.awt.*;
import java.awt.event.*;
import javax.swing.*;

/**
 * CardLayoutDemo zeigt die Implementierung und Funktion eines CardLayouts.
 * @author Gernot Segieth
 */
public class CardLayoutDemo {
  private CardLayout cl;

  public CardLayoutDemo() {
    //Komponenten vorbereiten
    //1. Das CardPanel
    cl = new CardLayout();
    JPanel cardPanel = new JPanel(cl);
    
    //2. Karten erzeugen und dem Kartenstapel hinzufügen
    cardPanel.add(new ColorPanel(Color.WHITE), "WEISS");
    cardPanel.add(new ColorPanel(Color.RED), "ROT");
    cardPanel.add(new ColorPanel(Color.BLUE), "BLAU");
    cardPanel.add(new ColorPanel(Color.YELLOW), "GELB");
    cardPanel.add(new ColorPanel(Color.BLACK), "SCHWARZ");
    cardPanel.add(new ColorPanel(Color.GREEN), "GRÜN");   
 
    //3. Das ButtonPanel für Benutzeraktionen
    JPanel buttonPanel = new JPanel(new FlowLayout(FlowLayout.CENTER));

    //4. Buttons erzeugen
    JButton forwardButton = new JButton("Weiter");
    forwardButton.addActionListener(new ActionListener() {
      public void actionPerformed(ActionEvent e) {
         cl.next(cardPanel);
      }
    });

    JButton rearwardButton = new JButton("Zurück");
    rearwardButton.addActionListener(new ActionListener() {
      public void actionPerformed(ActionEvent e) {
         cl.previous(cardPanel);
      }
    });

    JButton yellowButton = new JButton("Gelb!");
    yellowButton.addActionListener(new ActionListener() {
      public void actionPerformed(ActionEvent e) {
         cl.show(cardPanel, "GELB"); //"GELB" ist der Wert, mit dem oben das gelbe JPanel dem CardLayout übergeben wurde.
      }
    });

    //6. Buttons ins ButtonPanel einfügen
    buttonPanel.add(rearwardButton); 
    buttonPanel.add(forwardButton);
    buttonPanel.add(yellowButton);

    //7. Komponenten einem JFrame hinzufügen
    JFrame frame = new JFrame("CardLayout-Demo");
    frame.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
    frame.add(cardPanel, BorderLayout.CENTER);
    frame.add(buttonPanel, BorderLayout.SOUTH);
    frame.pack();
    frame.setLocationRelativeTo(null);
    frame.setVisible(true);
  }

  public static void main(String[] args) {
    SwingUtilities.invokeLater(new Runnable() {
      public void run() {
        new CardLayoutDemo();
      }
    });
  }
}

Das Ergebnis auf dem Bildschirm sieht dann so aus:

CardLayoutDemo.png


Fragen

Das Thema wurde nicht ausreichend behandelt? Du hast Fragen dazu und brauchst weitere Informationen? Lass Dir von uns helfen!

Wir helfen dir gerne!


Dir hat dieser Artikel gefallen? Oder Du hast Fehler entdeckt und möchtest zur Berichtigung beitragen? Prima! Schreibe einen Kommentar!

Du musst angemeldet sein, um einen Kommentar abzugeben.


Quellen und weiterführendes Material


--L-ectron-X 25.10.2013