Rheinwerk Computing < openbook > Rheinwerk Computing - Professionelle Bücher. Auch für Einsteiger.
Professionelle Bücher. Auch für Einsteiger.

Inhaltsverzeichnis
Vorwort
1 Java ist auch eine Sprache
2 Sprachbeschreibung
3 Klassen und Objekte
4 Der Umgang mit Zeichenketten
5 Eigene Klassen schreiben
6 Exceptions
7 Generics<T>
8 Äußere.innere Klassen
9 Besondere Klassen der Java SE
10 Architektur, Design und angewandte Objektorientierung
11 Die Klassenbibliothek
12 Bits und Bytes und Mathematisches
13 Datenstrukturen und Algorithmen
14 Threads und nebenläufige Programmierung
15 Raum und Zeit
16 Dateien, Verzeichnisse und Dateizugriffe
17 Datenströme
18 Die eXtensible Markup Language (XML)
19 Grafische Oberflächen mit Swing
20 Grafikprogrammierung
21 Netzwerkprogrammierung
22 Verteilte Programmierung mit RMI
23 JavaServer Pages und Servlets
24 Datenbankmanagement mit JDBC
25 Reflection und Annotationen
26 Dienstprogramme für die Java-Umgebung
A Die Begleit-DVD
Stichwort
Ihre Meinung?

Spacer
 <<   zurück
Java ist auch eine Insel von Christian Ullenboom
Das umfassende Handbuch
Buch: Java ist auch eine Insel

Java ist auch eine Insel
geb., mit DVD
1482 S., 49,90 Euro
Rheinwerk Computing
ISBN 978-3-8362-1506-0
Pfeil 19 Grafische Oberflächen mit Swing
  Pfeil 19.1 Das Abstract Window Toolkit und Swing
    Pfeil 19.1.1 SwingSet-Demos
    Pfeil 19.1.2 Abstract Window Toolkit (AWT)
    Pfeil 19.1.3 Java Foundation Classes
    Pfeil 19.1.4 Was Swing von AWT unterscheidet
  Pfeil 19.2 Mit NetBeans zur ersten Oberfläche
    Pfeil 19.2.1 Projekt anlegen
    Pfeil 19.2.2 Gui-Klasse hinzufügen
    Pfeil 19.2.3 Programm starten
    Pfeil 19.2.4 Grafische Oberfläche aufbauen
    Pfeil 19.2.5 Swing-Komponenten-Klassen
    Pfeil 19.2.6 Funktionalität geben
  Pfeil 19.3 Fenster unter grafischen Oberflächen
    Pfeil 19.3.1 Swing-Fenster mit javax.swing.JFrame darstellen
    Pfeil 19.3.2 Fenster schließbar machen – setDefaultCloseOperation()
    Pfeil 19.3.3 Sichtbarkeit des Fensters
    Pfeil 19.3.4 Größe und Position des Fensters verändern
    Pfeil 19.3.5 Fenster- und Dialog-Dekoration, Transparenz *
    Pfeil 19.3.6 Dynamisches Layout während einer Größenänderung *
  Pfeil 19.4 Beschriftungen (JLabel)
    Pfeil 19.4.1 Mehrzeiliger Text, HTML in der Darstellung
  Pfeil 19.5 Icon und ImageIcon für Bilder auf Swing-Komponenten
    Pfeil 19.5.1 Die Klasse ImageIcon
    Pfeil 19.5.2 Die Schnittstelle Icon und eigene Icons *
  Pfeil 19.6 Es tut sich was – Ereignisse beim AWT
    Pfeil 19.6.1 Swings Ereignisquellen und Horcher (Listener)
    Pfeil 19.6.2 Listener implementieren
    Pfeil 19.6.3 Listener bei dem Ereignisauslöser anmelden/abmelden
    Pfeil 19.6.4 Aufrufen der Listener im AWT-Event-Thread
    Pfeil 19.6.5 Adapterklassen nutzen
    Pfeil 19.6.6 Innere Mitgliedsklassen und innere anonyme Klassen
    Pfeil 19.6.7 Ereignisse etwas genauer betrachtet *
  Pfeil 19.7 Schaltflächen
    Pfeil 19.7.1 Normale Schaltflächen (JButton)
    Pfeil 19.7.2 Der aufmerksame »ActionListener«
    Pfeil 19.7.3 Schaltflächen-Ereignisse vom Typ »ActionEvent«
    Pfeil 19.7.4 Basisklasse »AbstractButton«
    Pfeil 19.7.5 Wechselknopf (JToggleButton)
  Pfeil 19.8 Swing Action *
  Pfeil 19.9 JComponent und Component als Basis aller Komponenten
    Pfeil 19.9.1 Hinzufügen von Komponenten
    Pfeil 19.9.2 Tooltips (Kurzhinweise)
    Pfeil 19.9.3 Rahmen (Border) *
    Pfeil 19.9.4 Fokus und Navigation *
    Pfeil 19.9.5 Ereignisse jeder Komponente *
    Pfeil 19.9.6 Die Größe und Position einer Komponente *
    Pfeil 19.9.7 Komponenten-Ereignisse *
    Pfeil 19.9.8 Undurchsichtige (opake) Komponente *
    Pfeil 19.9.9 Properties und Listener für Änderungen *
  Pfeil 19.10 Container
    Pfeil 19.10.1 Standardcontainer (JPanel)
    Pfeil 19.10.2 Bereich mit automatischen Rollbalken (JScrollPane)
    Pfeil 19.10.3 Reiter (JTabbedPane)
    Pfeil 19.10.4 Teilungs-Komponente (JSplitPane)
  Pfeil 19.11 Alles Auslegungssache: die Layoutmanager
    Pfeil 19.11.1 Übersicht über Layoutmanager
    Pfeil 19.11.2 Zuweisen eines Layoutmanagers
    Pfeil 19.11.3 Im Fluss mit FlowLayout
    Pfeil 19.11.4 BoxLayout
    Pfeil 19.11.5 Mit BorderLayout in alle Himmelsrichtungen
    Pfeil 19.11.6 Rasteranordnung mit GridLayout
    Pfeil 19.11.7 Der GridBagLayoutmanager *
    Pfeil 19.11.8 Null-Layout *
    Pfeil 19.11.9 Weitere Layoutmanager
  Pfeil 19.12 Rollbalken und Schieberegler
    Pfeil 19.12.1 Schieberegler (JSlider)
    Pfeil 19.12.2 Rollbalken (JScrollBar) *
  Pfeil 19.13 Kontrollfelder, Optionsfelder, Kontrollfeldgruppen
    Pfeil 19.13.1 Kontrollfelder (JCheckBox)
    Pfeil 19.13.2 ItemSelectable, ItemListener und das ItemEvent
    Pfeil 19.13.3 Sich gegenseitig ausschließende Optionen (JRadioButton)
  Pfeil 19.14 Fortschritte bei Operationen überwachen *
    Pfeil 19.14.1 Fortschrittsbalken (JProgressBar)
    Pfeil 19.14.2 Dialog mit Fortschrittsanzeige (ProgressMonitor)
  Pfeil 19.15 Menüs und Symbolleisten
    Pfeil 19.15.1 Die Menüleisten und die Einträge
    Pfeil 19.15.2 Menüeinträge definieren
    Pfeil 19.15.3 Einträge durch Action-Objekte beschreiben
    Pfeil 19.15.4 Mit der Tastatur: Mnemonics und Shortcut
    Pfeil 19.15.5 Der Tastatur-Shortcut (Accelerator)
    Pfeil 19.15.6 Tastenkürzel (Mnemonics)
    Pfeil 19.15.7 Symbolleisten alias Toolbars
    Pfeil 19.15.8 Popup-Menüs
  Pfeil 19.16 Das Model-View-Controller-Konzept
  Pfeil 19.17 Auswahlmenüs, Listen und Spinner
    Pfeil 19.17.1 Auswahlmenü (JComboBox)
    Pfeil 19.17.2 Zuordnung einer Taste mit einem Eintrag *
    Pfeil 19.17.3 Datumsauswahl
    Pfeil 19.17.4 Listen (JList)
    Pfeil 19.17.5 Drehfeld (JSpinner) *
  Pfeil 19.18 Textkomponenten
    Pfeil 19.18.1 Text in einer Eingabezeile
    Pfeil 19.18.2 Die Oberklasse der Text-Komponenten (JTextComponent)
    Pfeil 19.18.3 Geschützte Eingaben (JPasswordField)
    Pfeil 19.18.4 Validierende Eingabefelder (JFormattedTextField)
    Pfeil 19.18.5 Einfache mehrzeilige Textfelder (JTextArea)
    Pfeil 19.18.6 Editor-Klasse (JEditorPane) *
  Pfeil 19.19 Tabellen (JTable)
    Pfeil 19.19.1 Ein eigenes Tabellen-Model
    Pfeil 19.19.2 Basisklasse für eigene Modelle (AbstractTableModel)
    Pfeil 19.19.3 Vorgefertigtes Standard-Modell (DefaultTableModel)
    Pfeil 19.19.4 Ein eigener Renderer für Tabellen
    Pfeil 19.19.5 Zell-Editoren
    Pfeil 19.19.6 Größe und Umrandung der Zellen *
    Pfeil 19.19.7 Spalteninformationen*
    Pfeil 19.19.8 Tabellenkopf von Swing-Tabellen *
    Pfeil 19.19.9 Selektionen einer Tabelle *
    Pfeil 19.19.10 Automatisches Sortieren und Filtern mit RowSorter *
  Pfeil 19.20 Bäume (JTree)
    Pfeil 19.20.1 JTree und sein TreeModel und TreeNode
    Pfeil 19.20.2 Selektionen bemerken
    Pfeil 19.20.3 Das TreeModel von JTree *
  Pfeil 19.21 JRootPane und JDesktopPane *
    Pfeil 19.21.1 Wurzelkomponente der Top-Level-Komponenten (JRootPane)
    Pfeil 19.21.2 JDesktopPane und die Kinder JInternalFrame
    Pfeil 19.21.3 JLayeredPane
  Pfeil 19.22 Dialoge und Window-Objekte
    Pfeil 19.22.1 JWindow und JDialog
    Pfeil 19.22.2 Modal oder nicht-modal
    Pfeil 19.22.3 Standarddialoge mit JOptionPane
    Pfeil 19.22.4 Der Dateiauswahldialog
    Pfeil 19.22.5 Der Farbauswahldialog JColorChooser *
  Pfeil 19.23 Flexibles Java-Look-and-Feel
    Pfeil 19.23.1 Look and Feel global setzen
    Pfeil 19.23.2 UIManager
    Pfeil 19.23.3 Windowsoptik mit JGoodies Looks verbessern *
  Pfeil 19.24 Swing-Komponenten neu erstellen oder verändern *
  Pfeil 19.25 Die Zwischenablage (Clipboard)
    Pfeil 19.25.1 Clipboard-Objekte
    Pfeil 19.25.2 Auf den Inhalt zugreifen mit »Transferable«
    Pfeil 19.25.3 DataFlavor ist das Format der Daten in der Zwischenablage
    Pfeil 19.25.4 Einfügungen in der Zwischenablage erkennen
    Pfeil 19.25.5 Drag
  Pfeil 19.26 AWT, Swing und die Threads
    Pfeil 19.26.1 Ereignisschlange (EventQueue) und AWT-Event-Thread
    Pfeil 19.26.2 Swing ist nicht thread-sicher
    Pfeil 19.26.3 »invokeLater()« und »invokeAndWait()«
    Pfeil 19.26.4 SwingWorker
    Pfeil 19.26.5 Eigene Ereignisse in die Queue setzen *
    Pfeil 19.26.6 Auf alle Ereignisse hören *
  Pfeil 19.27 Barrierefreiheit mit der Java Accessibility API
  Pfeil 19.28 Zeitliches Ausführen mit dem javax.swing.Timer
  Pfeil 19.29 Zum Weiterlesen


Rheinwerk Computing - Zum Seitenanfang

19.18 Textkomponenten  Zur nächsten ÜberschriftZur vorigen Überschrift

Swing bietet eine Reihe von Textkomponenten:

  • JTextField: einzeiliges Textfeld
  • JFormattedTextField: einzeiliges Textfeld mit Formatierungsvorgaben
  • JPasswordField: einzeilige Eingabe mit verdeckten Zeichen
  • JTextArea: mehrzeiliges Textfeld
  • JEditorPane: Editor-Komponente
  • JTextPane: Spezialisierung der Editor-Komponente

Die JEditorPane (mehr dazu in Abschnitt 19.18.6, »Editor-Klasse (JEditorPane)«) ist die leistungsfähigste Komponente, die über so genannte Editor-Kits reinen Text, HTML oder RTF darstellen und verwalten kann.


Hinweis Swings Textkomponenten sind sehr leistungsfähig und beeindruckend allemal, da Swing ja allerlei Dinge von Hand erledigt, da es nicht auf die nativen Textkomponenten vom grafischen Teil des Betriebssystems zurückgreift. Der aufwändigste Teil ist die korrekte Darstellung des Textes (die Java 2D übernimmt), aber Selektion, effektive Verwaltung von großen Textmengen, schnelles Scrolling, Tastaturkommandos, einfache Programmier-API sind weitere Anforderungen.


Viele wichtige Methoden sind in der Oberklasse javax.swing.text.JTextComponent zu finden. Zwar liegt diese Klasse im Paket javax.swing.text, doch liegen alle anderen Klassen »klassischerweise« unter javax.swing.


Rheinwerk Computing - Zum Seitenanfang

19.18.1 Text in einer Eingabezeile  Zur nächsten ÜberschriftZur vorigen Überschrift

Einzeilige Textfelder werden mit der Klasse JTextField erstellt. Unterschiedliche Konstruktoren legen einen Start-String oder die Anzahl der Zeichen fest, die ein Textfeld anzeigen kann. Ein JTextField löst mit der Enter -Taste ein ActionEvent auf diesen Ereignistyp aus, kennen wir schon von JButton.

Ein kleiner Rechner soll über eine Textzeile mit einer Länge von 20 Zeichen verfügen. Bei Aktivierung der Enter -Taste soll der Ausdruck berechnet werden und in der Textzeile erscheinen:

Listing 19.39  com/tutego/insel/ui/text/JTextFieldDemo.java, main()

JFrame frame = new JFrame();
frame.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );

final JTextField input = new JTextField( "12 * 3 + 2", 20 );
input.addActionListener( new ActionListener() {
  @Override public void actionPerformed( ActionEvent e ) {
    try {
      input.setText( "" +
        new ScriptEngineManager().getEngineByName("JavaScript").eval(input.Umbruch
          getText()) );
    }
    catch ( ScriptException ex ) {
      ex.printStackTrace();
    }
  }
} );
frame.add( input );
frame.pack();
frame.setVisible( true );

class javax.swing.JTextField
extends JTextComponent

  • JTextField() Erzeugt ein leeres Textfeld.
  • JTextField( int columns ) Erzeugt ein Textfeld mit einer gegebenen Anzahl von Spalten.
  • JTextField( String text ) Erzeugt ein mit text initialisiertes Textfeld.
  • JTextField( String text, int columns ) Erzeugt ein mit text initialisiertes Textfeld mit columns Spalten.

Rheinwerk Computing - Zum Seitenanfang

19.18.2 Die Oberklasse der Text-Komponenten (JTextComponent)  Zur nächsten ÜberschriftZur vorigen Überschrift

Alle Texteingabefelder unter Swing sind von der abstrakten Oberklasse JTextComponent abgeleitet. Die wichtigsten Methoden sind setText(String) und getText(), mit denen sich Zeichenketten setzen und erfragen lassen.


class javax.swing.text.JTextComponent
extends JComponent
implements Scrollable, Accessible

  • String getText() Liefert den Inhalt des Textfelds.
  • String getText( int offs, int len ) Liefert den Inhalt des Textfelds von offs bis offs + len. Stimmen die Bereiche nicht, wird eine BadLocationException ausgelöst.
  • String getSelectedText() Liefert den selektierten Text. Keine Selektion ergibt die Rückgabe null.
  • void setText( String t ) Setzt den Text neu.
  • void read( Reader in, Object desc ) throws IOException Liest den Inhalt aus dem Reader in das Textfeld. desc beschreibt den Datenstrom näher, kann aber null sein. Die read()-Methode erzeugt intern ein neues Document-Objekt und verwirft das alte.
  • void write( Writer out ) throws IOException Schreibt den Inhalt des Textfelds in den Writer.

Das Caret *

Der Cursor in einem Textfeld heißt Caret. Unterschiedliche Anfragen lassen sich an ein Textfeld stellen, um mehr über das Caret herauszufinden. Ein Listener kann an eine JTextComponent gehängt werden, und ebenso kann das Caret frei bewegt werden.


class javax.swing.text.JTextComponent
extends JComponent
implements Scrollable, Accessible

  • int getCaretPosition(), setCaretPosition( int position ) Liefert beziehungsweise verändert die Position des Eingabe-Cursors.
  • Color getCaretColor(), void setCaretColor( Color c ) Liest oder ändert die Farbe des Carets.

Beispiel Der Cursor soll an das Textende gesetzt werden. textfield.getText().length() erfragt die Länge des Strings, und textfield.setCaretPosition() setzt die Position des Cursors. Für ein Textfeld textfield ist Folgendes also die Lösung:

textfield.setCaretPosition( textfield.getText().length() );


Rheinwerk Computing - Zum Seitenanfang

19.18.3 Geschützte Eingaben (JPasswordField)  Zur nächsten ÜberschriftZur vorigen Überschrift

Das JPasswordField ist ein spezielles JTextField, das die Zeichen nicht auf dem Bildschirm darstellt, sondern ein alternatives Zeichen zeigt, das so genannte Echozeichen. Standardmäßig ist das ein Sternchen. So lassen sich Passwort-Felder anlegen, die eine Eingabe verbergen:

Listing 19.40  com/tutego/insel/ui/text/JPasswordFieldDemo.java, Ausschnitt

JPasswordField pass = new JPasswordField( 15 );
pass.setEchoChar( '#' );
comp.add( pass );

Im Konstruktor geben wir die Länge der Textzeile an. Mit der Methode setEchoChar() lässt sich das Echozeichen festlegen. [Wird das Echozeichen auf (char)0 gesetzt, erscheint die Eingabe nicht im Klartext. So macht es nur die AWT-Komponente TextField. ]

Leider bleibt das Problem, dass die Sternchen auf die Anzahl der geheimen Zeichen schließen lassen.

Abbildung 19.19  Das Passwort-Feld


Rheinwerk Computing - Zum Seitenanfang

19.18.4 Validierende Eingabefelder (JFormattedTextField)  Zur nächsten ÜberschriftZur vorigen Überschrift

Textfelder, in denen Benutzer Zeichenfolgen eintragen, müssen oft die Eingabe validieren. So dürfen Zahlenfelder keine beliebigen Zeichen annehmen, sondern nur Ziffern und vielleicht Vorzeichen oder Dezimaltrenner. Komplizierte Felder wie ISBN-Nummern oder Datumsformate haben noch weitere Regeln. Eine Implementierung dieser Textfelder sieht häufig so aus, dass auf Tastatureingaben reagiert und sofort geprüft wird, ob alles in Ordnung ist, oder später nach einer actionPerformed(). Schlaue Programmierer nutzen gern die parse()-Methode des Format-Objekts aus dem text-Paket, um die Beschränkungen zu prüfen.

Die Swing-Komponente JFormattedTextField ist ein JTextField mit einer Möglichkeit zur Formatierung und Validierung der Daten. Gültige Werte bestimmt ein im Konstruktor übergebenes java.text.Format-Objekt. Wollen wir Zahlenformate testen, geben wir zum Beispiel ein SimpleDateFormat-Objekt mit und für Dezimalfeldeingaben ein DecimalFormat-Exemplar.

Das folgende Programm zeigt die Anwendung eines Eingabefelds, das nur Datumswerte eines bestimmten Formats und Dezimalzahlen annimmt:

Listing 19.41  com/tutego/insel/ui/text/JFormattedTextDemo.java

JFrame frame = new JFrame();
frame.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );
frame.setLayout( new GridLayout(0,1) );

ActionListener actionListener = new ActionListener() {
  @Override public void actionPerformed( ActionEvent e ) {
    System.out.println( ((JFormattedTextField)e.getSource()).getText() );
} };

JTextField textField1 = new JFormattedTextField(
    new SimpleDateFormat("MM/dd/yy") );
frame.add( textField1 );
textField1.addActionListener( actionListener );

JTextField textField2 = new JFormattedTextField(
    new DecimalFormat("#,###") );
frame.add( textField2 );
textField2.addActionListener( actionListener );

frame.pack();
frame.setVisible( true );

Hinweis Während der Eingabe, also bei jedem Tastendruck, testet JFormattedTextField die Zeichenkette nicht auf ihre Korrektheit. So lässt sich in beide Textfelder erst einmal beliebiger Text eintragen. Erst bei einem Fokuswechsel oder einer Bestätigung mit Enter arbeitet die Validierung von JTextField. Hier allerdings nicht konsistent. Während bei einem zugewiesenen Datumsformat Eingaben wie »23/234/334« noch durchgehen und offensichtlich falsche Eingaben wie »blub« abgewiesen werden und nicht zu einem ActionEvent führen, benachrichtigt JTextField mit einem DecimalFormat("#,###") und dem Text »1,bla« unseren ActionListener. Das ist natürlich unsinnig, und wir müssen erneut prüfen. Ein Fokuswechsel validiert jedoch und trägt in das Textfeld »1« ein.



Rheinwerk Computing - Zum Seitenanfang

19.18.5 Einfache mehrzeilige Textfelder (JTextArea)  Zur nächsten ÜberschriftZur vorigen Überschrift

Mit der Klasse JTextArea lassen sich mehrzeilige editierbare Textfelder erzeugen. Der Zeichensatz kann genau ein Attribut annehmen, das heißt, die Schrift verfügt über genau eine Farbe und eine Schriftart; der Zeichensatz lässt sich mit setFont(Font) zuweisen.

Die JTextArea-Klasse stellt im Gegensatz zur AWT-Komponente TextArea keine automatischen Bildlaufleisten dar, eine Scroll-Eigenschaft muss nachträglich über eine JScrollPane realisiert werden:

Listing 19.42  com/tutego/insel/ui/text/JTextAreaDemo.java

package com.tutego.insel.ui.text;

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

class JTextAreaDemo extends JFrame
{
  private Font font = new Font(Font.SANS_SERIF, Font.PLAIN, 12 );

  public JTextAreaDemo()
  {
    setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );

    final JTextArea t = new JTextArea();
    t.setFont( font );
    add( new JScrollPane( t ) );

    ActionListener al = new ActionListener()
    {
      @Override public void actionPerformed( ActionEvent e )
      {
        if ( "Ende".equals(e.getActionCommand()) )
          System.exit( 0 );
        if ( "fett".equals(e.getActionCommand()) )
          t.setFont( font = font.deriveFont( font.getStyle() ^ Font.BOLD ) );
        else if ( "kursiv".equals(e.getActionCommand()) )
          t.setFont( font = font.deriveFont( font.getStyle() ^ Font.ITALIC ) );
      }
    };

    JPanel panel = new JPanel( new GridLayout(1,3) );
    add( panel, BorderLayout.PAGE_START );

    AbstractButton button;

    panel.add( button = new JToggleButton("fett") );
    button.addActionListener( al );
    button.setFont( font.deriveFont( Font.BOLD ) );

    panel.add( button = new JToggleButton("kursiv") );
    button.addActionListener( al );
    button.setFont( font.deriveFont( Font.ITALIC ) );

    panel.add( button = new JButton("Ende") );
    button.addActionListener( al );

    setSize( 400, 600 );
  }

  public static void main( String[] args )
  {
    new JTextAreaDemo().setVisible( true );
  }
}

Die Zeile mit der Anweisung font.getStyle() ^ Font.BOLD dreht über den Xor-Operator das entsprechende Flag um. War das Bit für Font.BOLD vorher gesetzt, ist es nach der Xor-Operation gelöscht. Genauso ist es umgekehrt: War es nicht gesetzt, ist es anschließend gesetzt. Die Konstanten sind mit 1 (BOLD), 2 (ITALIC) vorbelegt – also einmal Bit 1 und einmal Bit 2.

Abbildung 19.20  Eine JTextArea


class javax.swing.JTextArea
extends JTextComponent

  • JTextArea() Ein neues JTextArea-Objekt wird erzeugt.
  • JTextArea( int rows, int columns ) Erzeugt ein neues Objekt mit gegebener Anzahl an Zeilen und Spalten.
  • JTextArea( String text ) Erzeugt ein JTextArea-Objekt mit einem Starttext.
  • JTextArea( String, int rows, int columns ) Eine Kombination aus den beiden vorigen Konstruktoren.

Unterschiedliche Methoden erfragen das Layout und erlauben eine Änderung:

  • int getColumns(), int getRows() Gibt die Anzahl der Spalten und Zeilen an.
  • void setColumns( int columns ), void setRows( int rows ) Setzt die Anzahl der Spalten und Zeilen neu.
  • int getLineCount() Liefert die Anzahl der Zeilen.

Praktisch sind die int-gebenden Methoden getLineEndOffset(int line), getLineStartOffset(int line) und getLineOfOffset(int offset), die Zeichen-Position mit Zeilennummern zusammenbringen.

Modifikationen des Textes sind ebenfalls möglich und gehen über die Methoden der Oberklasse JTextComponent hinaus:

  • void append( String str ) Hängt den String an den vorhandenen Text an. Diese Methode steht in der Oberklasse JTextComponent nicht zur Verfügung.
  • void insert( String str, int pos ) Fügt den String an die Position pos ein.
  • void replaceRange( String str, int start, int end ) Ersetzt Text von start bis end durch den neuen Text str.

Scrolling

Wie üblich besitzt die JTextArea keine Rollbalken und muss zwecks Scrolling in eine JScrollPane eingebaut werden. Es ist praktisch, zu wissen, dass sich einzelne Rollbalken einer JScrollPane mit get[Vertical|Horizontal]ScrollBar erfragen lassen. Denn wenn zum Beispiel am Ende etwas angehängt wird, scrollt die JTextArea nicht automatisch mit nach unten. Nach dem Einfügen können wir jedoch den vertikalen Rollbalken erfragen und von Hand den Wert auf das Maximum setzen:

JScrollBar bar = scrollPane.getVerticalScrollBar();
bar.setValue( bar.getMaximum() );

Rheinwerk Computing - Zum Seitenanfang

19.18.6 Editor-Klasse (JEditorPane) *  topZur vorigen Überschrift

Die Klasse JEditorPane ist eine sehr leistungsfähige Textkomponente für verschiedene Textformate. Die Swing-Implementierung unterstützt HTML und Rich Text Format (RTF), eigene Implementierungen lassen sich ohne große Probleme ergänzen. Diese werden Editor-Kits genannt. Der Editor stellt Text dar, der ihm mit setContentType() übergeben wird. Das Editor-Kit wird dann mit setEditorKit() zugewiesen. Ohne eigene Erweiterungen sind »text/html« (Standard), »text/plain« und »text/rtf« erlaubt. Soll nur Text ohne Formatierungen und ohne Attribute dargestellt werden, lässt sich auch gleich JTextArea verwenden.

Meistens wird eine JEditorPane über einen Konstruktor erzeugt, dem eine URL oder ein String mit einer URL übergeben wird. Für Programme mit Dateien auf dem lokalen Dateisystem wird dann die URL mit file:// beginnen. Wird mit dem Standard-Konstruktor gearbeitet, kann später mit setPage() ein URL-Objekt oder ein String eine Seite neu belegen. Auch setText() erlaubt ein Setzen des Inhalts. Zu guter Letzt lässt sich der Editor auch mit einem InputStream über read() mit Inhalt füllen.

Mit diesem Wissen lässt sich ein kleiner Webbrowser implementieren:

Listing 19.43  com/tutego/insel/ui/text/JBrowser.java

package com.tutego.insel.ui.text;

import javax.swing.*;
import javax.swing.event.*;
import java.io.*;
import java.net.*;

public class JBrowser extends JEditorPane implements HyperlinkListener
{
  JBrowser( String url )
  {
    setEditable( false );
    addHyperlinkListener( this );

    try
    {
      setPage( new URL(url) );
    }
    catch ( IOException e ) { e.printStackTrace(); }
  }

  @Override public void hyperlinkUpdate( HyperlinkEvent event )
  {
    HyperlinkEvent.EventType typ = event.getEventType();

    if ( typ == HyperlinkEvent.EventType.ACTIVATED )
    {
      try
      {
        setPage( event.getURL() );
      }
      catch( IOException e ) {
        JOptionPane.showMessageDialog( this,
                                      "Kann dem Link nicht folgen: "
                                        + event.getURL().toExternalForm(),
                                      "Ladefehler",
                                      JOptionPane.ERROR_MESSAGE );
      }
    }
  }

  public static void main( String[] args )
  {
    JFrame f = new JFrame();
    f.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );
    f.setSize( 600, 500 );
    f.add( new JScrollPane(new JBrowser("http://www.heise.de/index.html")) );
    f.setVisible( true );
  }
}

class javax.swing.JEditorPane
extends JTextComponent

  • JEditorPane() Erzeugt einen neuen Editor.
  • JEditorPane( String url ), JEditorPane( URL url ) Erzeugt einen neuen Editor mit dem Inhalt, auf den die URL zeigt.
  • void setPage( String url ), void setPage( URL page ) Zeigt eine neue Seite an.
  • void addHyperlinkListener( HyperlinkListener l ) Reagiert auf das Aktivieren von Hyperlinks.
  • void removeHyperlinkListener( HyperlinkListener l ) Entfernt den Horcher.


Ihr Kommentar

Wie hat Ihnen das <openbook> gefallen? Wir freuen uns immer über Ihre freundlichen und kritischen Rückmeldungen. >> Zum Feedback-Formular
 <<   zurück
 Ihre Meinung?
Wie hat Ihnen das <openbook> gefallen?
Ihre Meinung

 Buchempfehlungen
Zum Katalog: Java ist auch eine Insel






 Java ist auch
 eine Insel


Zum Katalog: Java SE Bibliotheken






 Java SE Bibliotheken


Zum Katalog: Professionell entwickeln mit Java EE 7






 Professionell
 entwickeln mit
 Java EE 7


Zum Katalog: Einstieg in Eclipse






 Einstieg in
 Eclipse


Zum Katalog: Einstieg in Java






 Einstieg in
 Java


 Shopping
Versandkostenfrei bestellen in Deutschland und Österreich
InfoInfo




Copyright © Rheinwerk Verlag GmbH 2011
Für Ihren privaten Gebrauch dürfen Sie die Online-Version natürlich ausdrucken. Ansonsten unterliegt das <openbook> denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.


Nutzungsbestimmungen | Datenschutz | Impressum

Rheinwerk Verlag GmbH, Rheinwerkallee 4, 53227 Bonn, Tel.: 0228.42150.0, Fax 0228.42150.77, service@rheinwerk-verlag.de