Swing: Unterschied zwischen den Versionen

Aus SibiWiki
Zur Navigation springen Zur Suche springen
Zeile 16: Zeile 16:
Man kann auch Container in andere Container packen (Ausnahme: JFrame).
Man kann auch Container in andere Container packen (Ausnahme: JFrame).


* '''[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_003.htm#mj6ee2c84afdbd3308eae62e58c0779add JFrame]''': Ein Fenster, das oben eine blaue Leiste hat für die Überschrift und das man schließen kann. Einen JFrame braucht man immer, weil JFrames selbstständig auf dem Bildschirm erscheinen können; alle anderen Elemente müssen in einen JFrame reingepackt werden.
* '''<code>[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_003.htm#mj6ee2c84afdbd3308eae62e58c0779add JFrame]''': Ein Fenster, das oben eine blaue Leiste hat für die Überschrift und das man schließen kann. Einen JFrame braucht man immer, weil JFrames selbstständig auf dem Bildschirm erscheinen können; alle anderen Elemente müssen in einen JFrame reingepackt werden.
* '''[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_010.htm#mj5c3ca432ef021d9c5cd26a5441702e99 JPanel]''': Ein Container, der eigentlich unsichtbar ist; JPanel dienen dazu, andere Elemente zusammenzufassen.
* '''<code>[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_010.htm#mj5c3ca432ef021d9c5cd26a5441702e99 JPanel]''': Ein Container, der eigentlich unsichtbar ist; JPanel dienen dazu, andere Elemente zusammenzufassen.
* '''[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_010.htm#mj66f472599b8b53fe93ea7adde5f179c3 JScrollPane]''': Ein Container, der Scrollbars bereitstellt, wenn der Inhalt zu groß ist, um ihn ganz im Container darzustellen.
* '''<code>[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_010.htm#mj66f472599b8b53fe93ea7adde5f179c3 JScrollPane]''': Ein Container, der Scrollbars bereitstellt, wenn der Inhalt zu groß ist, um ihn ganz im Container darzustellen.


==wichtige Methoden==
==wichtige Methoden==
* '''add(...)''': fügt ein Element hinzu.
* '''<code>add(...)''': fügt ein Element hinzu.
* '''remove(...)''': entfernt ein Element.
* '''<code>remove(...)''': entfernt ein Element.
* '''setSize(int width, int height)'''
* '''<code>setSize(int width, int height)'''
* '''revalidate()''' : wenn man dem Container ein neues Element hinzugefügt hat, dann muss man diese Methode aufrufen, damit der Container seine Größe anpasst. Am besten ruft man direkt danach repaint() (s.u.) auf.
* '''<code>revalidate()''' : wenn man dem Container ein neues Element hinzugefügt hat, dann muss man diese Methode aufrufen, damit der Container seine Größe anpasst. Am besten ruft man direkt danach repaint() (s.u.) auf.
* '''repaint()''' : sorgt dafür, dass der Container neu gezeichnet wird.  
* '''<code>repaint()''' : sorgt dafür, dass der Container neu gezeichnet wird.  
* '''setVisible(boolean pVisible)'''
* '''<code>setVisible(boolean pVisible)'''
* '''setLayout(...)'''; z.B. setLayout(new BorderLayout());
* '''<code>setLayout(...)'''; z.B. <code>setLayout(new BorderLayout());
* ''für JFrame:'' '''getContentPane()''': gibt den eigentlichen Inhalt des JFrame zurück.
* ''für JFrame:'' '''<code>getContentPane()''': gibt den eigentlichen Inhalt des JFrame zurück.
* ''für JFrame:'' '''setContentPane(...)''': Platziert ein Element im JFrame. <u>Vorsicht: add(...) funktioniert für JFrame nicht!</u> ''(Das ist nicht grade intuitiv, ist aber leider so.)''
* ''für JFrame:'' '''<code>setContentPane(...)''': Platziert ein Element im JFrame. <u>Vorsicht: add(...) funktioniert für JFrame nicht!</u> ''(Das ist nicht grade intuitiv, ist aber leider so.)''


=Layout=
=Layout=
Jeder Container braucht ein Layout, in dem festgelegt wird, wie die Elemente im Container angeordnet werden.
Jeder Container braucht ein Layout, in dem festgelegt wird, wie die Elemente im Container angeordnet werden.
* '''BorderLayout''': Das BorderLayout legt fünf Regionen fest: BorderLayout.CENTER, BorderLayout.NORTH, BorderLayout.SOUTH, BorderLayout.WEST, BorderLayout.EAST. In jeder der fünf Regionen kann nur ein Element platziert werden; das kann aber auch ein JPanel sein.
* '''<code>BorderLayout''': Das BorderLayout legt fünf Regionen fest: <code>BorderLayout.CENTER, <code>BorderLayout.NORTH, <code>BorderLayout.SOUTH, <code>BorderLayout.WEST, <code>BorderLayout.EAST. In jeder der fünf Regionen kann nur ein Element platziert werden; das kann aber auch ein JPanel sein.
* '''AbsoluteLayout''': Dieses Layout ermöglicht es einem, die Elemente an Positionen zu platzieren, die man durch Koordinaten angibt (bzw. mit dem WindowBuilder zieht man die Komponenten an die passende Stelle.) Das ist praktisch, wenn man sicher weiß, dass die Elemente eine feste Größe haben.
* '''<code>AbsoluteLayout''': Dieses Layout ermöglicht es einem, die Elemente an Positionen zu platzieren, die man durch Koordinaten angibt (bzw. mit dem WindowBuilder zieht man die Komponenten an die passende Stelle.) Das ist praktisch, wenn man sicher weiß, dass die Elemente eine feste Größe haben.
* '''BoxLayout''': BoxLayout ermöglicht, mehrere Elemente nebeneinander (X_AXIS) oder untereinander (Y_AXIS) zu platzieren.
* '''<code>BoxLayout''': BoxLayout ermöglicht, mehrere Elemente nebeneinander (<code>X_AXIS) oder untereinander (<code>Y_AXIS) zu platzieren.


=Components=
=Components=
* '''[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_004.htm#mj60ce3a2ffc3e9bb53ce771e1be6ab815 JLabel]''': einzeilige Schrift; nicht editierbar.
* '''<code>[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_004.htm#mj60ce3a2ffc3e9bb53ce771e1be6ab815 JLabel]''': einzeilige Schrift; nicht editierbar.
* '''JTextField''': einzeiliges Textfeld; editierbar.
* '''<code>JTextField''': einzeiliges Textfeld; editierbar.
* '''[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_018.htm#mjcf36ecd72996f6d1103fe68e3b029b51 JTextArea]''': mehrzeiliges Textfeld; editierbar. Um Text in mehreren Zeilen anzuzeigen, muss man als Zeilenumbruch "\n" einbauen.
* '''<code>[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_018.htm#mjcf36ecd72996f6d1103fe68e3b029b51 JTextArea]''': mehrzeiliges Textfeld; editierbar. Um Text in mehreren Zeilen anzuzeigen, muss man als Zeilenumbruch "\n" einbauen.
* '''[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_007.htm#mj9241ccf572ee0550ef5d590db21dff5f JButton]''': ein Button. Um das Klicken abzufangen, muss an den Button ein ActionListener angehängt werden; das macht man am besten mit dem WindowBuilder.
* '''<code>[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_007.htm#mj9241ccf572ee0550ef5d590db21dff5f JButton]''': ein Button. Um das Klicken abzufangen, muss an den Button ein <code>ActionListener angehängt werden; das macht man am besten mit dem WindowBuilder.
* '''[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_013.htm#mj2721ba12d1970cb13863fdd31b8c8646 JCheckbox]''' und '''[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_013.htm#mj43810aa1240cd64b6fb6198331e55f04 JRadioButton]''': wichtig, um von vielen Möglichkeiten <u>mehrere</u> auszuwählen. Bei der JCheckbox kann man in der Regel mehrere anklicken; den JRadioButton benutzt man, wenn man von vielen Möglichkeiten nur <u>eine</u> wählen darf. Dafür müssen die JRadioButtons zu einer '''ButtonGroup''' hinzugefügt werden.
* '''<code>[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_013.htm#mj2721ba12d1970cb13863fdd31b8c8646 JCheckbox]''' und '''<code>[http://openbook.rheinwerk-verlag.de/javainsel9/javainsel_19_013.htm#mj43810aa1240cd64b6fb6198331e55f04 JRadioButton]''': wichtig, um von vielen Möglichkeiten <u>mehrere</u> auszuwählen. Bei der <code>JCheckbox kann man in der Regel mehrere anklicken; den <code>JRadioButton benutzt man, wenn man von vielen Möglichkeiten nur <u>eine</u> wählen darf. Dafür müssen die <code>JRadioButtons zu einer '''<code>ButtonGroup''' hinzugefügt werden.


==wichtige Methoden==
==wichtige Methoden==
* setText(String pText)
* <code>setText(String pText)
* getText()
* <code>getText()
* isSelected()  ''nur für JCheckbox und JRadioButton''
* <code>isSelected()  ''nur für JCheckbox und JRadioButton''


=JOptionPane=
=JOptionPane=
'''[http://openbook.rheinwerk-verlag.de/javainsel/javainsel_11_007.html#dodtpf70d8a68-8fa2-453d-8865-013ff8edd377 JOptionPane]''' dient dazu, kleine Fenster aufzumachen, z.B. um eine Bestätigung oder Eingabe vom Nutzer abzufragen. Die Abarbeitung der aufrufenden Methode wartet so lange, bis der Nutzer das Fenster durch OK oder Abbrechen zugemacht hat.
'''<code>[http://openbook.rheinwerk-verlag.de/javainsel/javainsel_11_007.html#dodtpf70d8a68-8fa2-453d-8865-013ff8edd377 JOptionPane]''' dient dazu, kleine Fenster aufzumachen, z.B. um eine Bestätigung oder Eingabe vom Nutzer abzufragen. Die Abarbeitung der aufrufenden Methode wartet so lange, bis der Nutzer das Fenster durch OK oder Abbrechen zugemacht hat.


==wichtige Methoden==
==wichtige Methoden==
* '''JOptionPane.showInputDialog(String pFrage)''': Fragt eine Texteingabe vom Nutzer ab. Gibt einen String zurück.
* '''<code>JOptionPane.showInputDialog(String pFrage)''': Fragt eine Texteingabe vom Nutzer ab. Gibt einen String zurück.
* '''JOptionPane.showMessageDialog(Component parentComponent, String pMessage)''': Informiert den Nutzer über irgendetwas. parentComponent kann null sein. Gibt <code>void</code> zurück.* '''JOptionPane.showConfirmDialog(Component parentComponent, String pFrage)''': Fragt nach einer Bestätigung (Ja, Nein, Abbrechen). parentComponent kann null sein. Gibt <code>int</code> zurück. Die möglichen Rückgaben sind:
* '''<code>JOptionPane.showMessageDialog(Component parentComponent, String pMessage)''': Informiert den Nutzer über irgendetwas. <code>parentComponent kann <code>null sein. Gibt <code>void</code> zurück.
** JOptionPane.YES_OPTION
* '''<code>JOptionPane.showConfirmDialog(Component parentComponent, String pFrage)''': Fragt nach einer Bestätigung (Ja, Nein, Abbrechen). <code>parentComponent kann <code>null sein. Gibt <code>int</code> zurück. Die möglichen Rückgaben sind:
** JOptionPane.NO_OPTION
** <code>JOptionPane.YES_OPTION
** JOptionPane.CANCEL_OPTION
** <code>JOptionPane.NO_OPTION
** <code>JOptionPane.CANCEL_OPTION
** Die Rückgaben überprüft man z.B. so:
** Die Rückgaben überprüft man z.B. so:
<code>
<code>

Version vom 14. Mai 2015, 22:15 Uhr


Swing ist eine Java-Bibliothek, mit der man Benutzeroberflächen bauen kann.

Es lohnt sich nicht mehr zu tief in Swing einzusteigen, weil es ab Java 1.8 die neue Bibliothek JavaFX gibt, die mehr Funktionalität hat (z.B. Integration von Stylesheets) und sich u.a. auch für die Entwicklung von Benutzeroberflächen für Apps eignet.

Allerdings ist Swing immer noch geeignet, wenn man mal "ganz schnell" eine grafische Oberfläche für ein Programm braucht!

Deswegen werden hier nur wenige wesentliche Elemente von Swing benannt.

Swing lässt sich am besten mit einem geeigneten Plugin entwickeln, z.B. dem WindowBuilder für Eclipse.

Container

In Container kann man andere Oberflächenelemente reinpacken. Sie brauchen deswegen ein definiertes Layout.

Man kann auch Container in andere Container packen (Ausnahme: JFrame).

  • JFrame: Ein Fenster, das oben eine blaue Leiste hat für die Überschrift und das man schließen kann. Einen JFrame braucht man immer, weil JFrames selbstständig auf dem Bildschirm erscheinen können; alle anderen Elemente müssen in einen JFrame reingepackt werden.
  • JPanel: Ein Container, der eigentlich unsichtbar ist; JPanel dienen dazu, andere Elemente zusammenzufassen.
  • JScrollPane: Ein Container, der Scrollbars bereitstellt, wenn der Inhalt zu groß ist, um ihn ganz im Container darzustellen.

wichtige Methoden

  • add(...): fügt ein Element hinzu.
  • remove(...): entfernt ein Element.
  • setSize(int width, int height)
  • revalidate() : wenn man dem Container ein neues Element hinzugefügt hat, dann muss man diese Methode aufrufen, damit der Container seine Größe anpasst. Am besten ruft man direkt danach repaint() (s.u.) auf.
  • repaint() : sorgt dafür, dass der Container neu gezeichnet wird.
  • setVisible(boolean pVisible)
  • setLayout(...); z.B. setLayout(new BorderLayout());
  • für JFrame: getContentPane(): gibt den eigentlichen Inhalt des JFrame zurück.
  • für JFrame: setContentPane(...): Platziert ein Element im JFrame. Vorsicht: add(...) funktioniert für JFrame nicht! (Das ist nicht grade intuitiv, ist aber leider so.)

Layout

Jeder Container braucht ein Layout, in dem festgelegt wird, wie die Elemente im Container angeordnet werden.

  • BorderLayout: Das BorderLayout legt fünf Regionen fest: BorderLayout.CENTER, BorderLayout.NORTH, BorderLayout.SOUTH, BorderLayout.WEST, BorderLayout.EAST. In jeder der fünf Regionen kann nur ein Element platziert werden; das kann aber auch ein JPanel sein.
  • AbsoluteLayout: Dieses Layout ermöglicht es einem, die Elemente an Positionen zu platzieren, die man durch Koordinaten angibt (bzw. mit dem WindowBuilder zieht man die Komponenten an die passende Stelle.) Das ist praktisch, wenn man sicher weiß, dass die Elemente eine feste Größe haben.
  • BoxLayout: BoxLayout ermöglicht, mehrere Elemente nebeneinander (X_AXIS) oder untereinander (Y_AXIS) zu platzieren.

Components

  • JLabel: einzeilige Schrift; nicht editierbar.
  • JTextField: einzeiliges Textfeld; editierbar.
  • JTextArea: mehrzeiliges Textfeld; editierbar. Um Text in mehreren Zeilen anzuzeigen, muss man als Zeilenumbruch "\n" einbauen.
  • JButton: ein Button. Um das Klicken abzufangen, muss an den Button ein ActionListener angehängt werden; das macht man am besten mit dem WindowBuilder.
  • JCheckbox und JRadioButton: wichtig, um von vielen Möglichkeiten mehrere auszuwählen. Bei der JCheckbox kann man in der Regel mehrere anklicken; den JRadioButton benutzt man, wenn man von vielen Möglichkeiten nur eine wählen darf. Dafür müssen die JRadioButtons zu einer ButtonGroup hinzugefügt werden.

wichtige Methoden

  • setText(String pText)
  • getText()
  • isSelected() nur für JCheckbox und JRadioButton

JOptionPane

JOptionPane dient dazu, kleine Fenster aufzumachen, z.B. um eine Bestätigung oder Eingabe vom Nutzer abzufragen. Die Abarbeitung der aufrufenden Methode wartet so lange, bis der Nutzer das Fenster durch OK oder Abbrechen zugemacht hat.

wichtige Methoden

  • JOptionPane.showInputDialog(String pFrage): Fragt eine Texteingabe vom Nutzer ab. Gibt einen String zurück.
  • JOptionPane.showMessageDialog(Component parentComponent, String pMessage): Informiert den Nutzer über irgendetwas. parentComponent kann null sein. Gibt void zurück.
  • JOptionPane.showConfirmDialog(Component parentComponent, String pFrage): Fragt nach einer Bestätigung (Ja, Nein, Abbrechen). parentComponent kann null sein. Gibt int zurück. Die möglichen Rückgaben sind:
    • JOptionPane.YES_OPTION
    • JOptionPane.NO_OPTION
    • JOptionPane.CANCEL_OPTION
    • Die Rückgaben überprüft man z.B. so:

int gewaehlt = JOptionPane.showConfirmDialog(null, "Nochmal?");
if(gewaehlt == JOptionPane.YES_OPTION)
{...}
else if (gewaehlt == JOptionPane.NO_OPTION)
{...}
else
{...}