java.sun.com

   JAVA - Graphische Komponenten - TextArea


 Startseite
 Graphische Komponenten

 Indexverzeichnis


JAVA - Graphische Komponenten - TextArea

Constructor
Methoden
Indexvariablen
Vererbung
Beispiel

  Seitenende


Constructor

public TextArea() Erzeugt ein neues TextArea. Es hat beide Bildlaufleisten (horizontal und vertikal).
public TextArea(String text) Erzeugt ein neues TextArea mit einem Text. Es hat beide Bildlaufleisten (horizontal und vertikal).

Parameter: text - Text, der angezeigt werden soll

public TextArea(int rows, int columns) Erzeugt ein leeres TextArea mit rows Zeilen und colums Spalten. Es hat beide Bildlaufleisten (horizontal und vertikal).

Parameter:

  • rows - Anzahl der Zeilen
  • colums - Anzahl der Spalten
public TextArea(String text, int rows, int columns) Erzeugt ein neues TextArea mit dem Text text, und der angegebenen Anzahl von Zeilen und Spalten. Das Textfeld hat horizontale und vertikale Bildlaufleisten (Scrollbars).

Parameter:

  • text - Text, der im TextArea angezeigt werden soll
  • rows - Anzahl der Zeilen
  • columns - Anzahl der Spalten
public TextArea(String text, int rows, int columns, int scrollbars) Erzeugt ein neues TextArea mit dem Text text, und der angegebenen Anzahl von Zeilen, Spalten und zeigt die definierten Bildlaufleisten an. Als Scrollbars sind definiert:
SCROLLBARS_BOTH (beide: horizontal und vertikal), SCROLLBARS_VERTICAL_ONLY (nur vertikal), SCROLLBARS_HORIZONTAL_ONLY (nur horizontal) und SCROLLBARS_NONE (keine Bildlaufleisten). Jeder andere Wert ist "falsch" und führt dazu, daß beide Bildlaufleisten angezeigt werden (SCROLLBARS_BOTH).

Parameter:

  • text - Text, der im TextArea angezeigt werden soll
  • rows - Anzahl der Zeilen
  • columns - Anzahl der Spalten
  • scrollbars - Konstante, die die Art der Scrollbar/Bildlaufleisten definiert

  Seitenanfang


Methoden

public void addNotify() Erzeugt ein Handle auf das TextArea.Dieses Handle ermöglicht es, das Aussehen des TextArea zu ändern, ohne dessen Funktionalität zu ändern.

Überschreibt: addNotify in der Klasse java.awt.Component

public void append(String str) Hängt den angegebenen Text an den Text im TextArea an.

Parameter: str - Text, der an den vorhandenen Text im TextArea angehängt werden soll.

public void appendText(String str) Deprecated = nicht mehr gültig. Wurde ersetzt durch append(String).
public int getColumns() Gibt die Anzahl der Spalten des TextArea zurück.

Rückgabe: Anzahl der Spalten des TextArea

public Dimension getMinimumSize() Gibt die minimale Größe des TextArea zurück.

Rückgabe: empfohlene Größe des TextArea, um es anzeigen zu können
Überschreibt: Methode getMinimumSize in der Klasse java.awt.Component

public Dimension getMinimumSize(int rows, int columns) Gibt die minimale Größe des TextArea zurück, um dieses mit einer bestimmten Anzahl von Zeilen und Spalten richtig darstellen zu können.

Parameter:

  • rows - Anzahl der Zeilen
  • cols - Anzahl der Spalten
Rückgabe: die minimalen Maße des TextArea, die benötigt werden, um das TextArea mit rows Zeilen und cols Spalten darstellen zu können.
public Dimension getPreferredSize() Ermittelt die optimale Größe des TextArea.

Rückgabe: optimalen Abmaße, die benötigt werden, um das TextArea "optimal" darstellen zu können.
Überschreibt: Methode getPreferredSize in der Klasse java.awt.Component

public Dimension getPreferredSize(int rows, int columns) Ermittelt die optimale Größe für ein TextArea mit einer bestimmten Anzahl von Zeilen und Spalten.

Parameter:

  • rows - Anzahl der Zeilen
  • cols - Anzahl der Spalten
Rückgabe: Optimale Größe, die benötigt wird, um das TextArea mit rows Zeilen und cols Spalten optimal darstellen zu können.
public int getRows() Gibt die Anzahl der Zeilen des TextArea zurück.

Rückgabe: Anzahl der Zeilen des TextArea

public int getScrollbarVisibility() Gibt zurück, welche Bildlaufleisten/Scrollbars angezeigt werden.

Rückgabe: einen Integer-Wert, welche Bildlaufleisten/Scrollbars das TextArea hat.

public void insert(String str, int pos) Fügt einen Text an einer Stelle im TextArea ein.

Parameter:

  • str - Text, der eingefügt werden soll
  • pos - Position, an der der Text eingefügt werden soll.
public void insertText(String str, int pos) Deprecated = nicht mehr gültig. Wurde ersetzt durch insert(String, int).
public Dimension minimumSize() Deprecated = nicht mehr gültig. Wurde ersetzt durch getMinimumSize().

Überschreibt: minimumSize in der Klasse java.awt.Component

public Dimension minimumSize(int rows, int columns) Deprecated = nicht mehr gültig. Wurde ersetzt durch getMinimumSize(int, int).
protected String paramString() Gibt den String zurück, der der Status des TextArea beschreibt. Dieser String ist für den Debugger nützlich.

Rückgabe: Parameter-String des TextArea
Überschreibt: Methode paramString der Klasse java.awt.TextComponent

public Dimension preferredSize() Deprecated = nicht mehr gültig. Wurde ersetzt durch getPreferredSize().

Überschreibt: preferredSize in der Klasse java.awt.Component

public Dimension preferredSize(int rows, int columns) Deprecated = nicht mehr gültig. Wurde ersetzt durch getPreferredSize(int, int).
public void replaceRange(String str, int start, int end) Entfernt den Text, der zwischen der Start- und Endposition steht.

Parameter:

  • str - Text, der entfernt werden soll
  • start - Startposition
  • end - Endposition
public void replaceText(String str, int start, int end) Deprecated = nicht mehr gültig. Wurde ersetzt durch replaceRange(String, int, int).
public void setColumns(int columns) Legt die Anzahl der Spalten des TextArea fest.

Parameter: colunms - Anzahl der Spalten
Exception: IllegalArgumentException - wenn die Anzahl der Spalten kleiner als null ist.

public void setRows(int rows) Legt die Anzahl der Zeilen des TextArea fest.

Parameter: rows - Anzahl der Zeilen
Exception: IllegalArgumentException - wenn die Anzahl der Zeilen kleiner als null ist.


  Seitenanfang


Indexvariablen

public static final int SCROLLBARS_BOTH Erzeugt die horizontale und vertikale Bildlaufleiste/Scrollbar.
public static final int SCROLLBARS_HORIZONTAL_ONLY Erzeugt nur die horizontale Bildlaufleiste/Scrollbar.
public static final int SCROLLBARS_NONE Erzeugt keine Bildlaufleiste/Scrollbar.
public static final int SCROLLBARS_VERTICAL_ONLY Erzeugt nur die vertikale Bildlaufleiste/Scrollbar.

  Seitenanfang


Vererbung

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.TextComponent
              |
              +--java.awt.TextArea


  Seitenanfang


Beispiel

BeispielProgrammbeispiel: Ansehen
import java.applet.*;
import java.awt.*;

public class TextArea1 extends Applet {

  public void init(){
    setLayout(new FlowLayout());
                  
    TextArea ta1 = new TextArea();
    TextArea ta2 = new TextArea(5,7);
    TextArea ta3 = new TextArea("mit Text");
    TextArea ta4 = new TextArea("mit Text und Zeilen/Spalten",7,14);
    TextArea ta5 = new TextArea("Text, Zeilen, Spalten, Scrollbar", 3,9,Scrollbar.VERTICAL);
          
    add(ta1);
    add(ta2);
    add(ta3);
    add(ta4);
    add(ta5);

  }
}

Ein TextArea kann über fünf verschiedene Constructors definiert werden. Das erste TextArea ist ohne irgendwelche Parameter definiert TextArea ta1 = new TextArea();. Hier wird ein Standard-Maß für das TextArea verwendet. Es entspricht, wenn man den zweiten Constructor verwendet, den Werten TextArea ta2 = new TextArea(10,60);. Hier muß man aufpassen, da die Spaltenbreite unterschiedlich angezeigt wird.

Der dritte Constructor entspricht im Wesentlichen dem ersten, nur mit dem Unterschied, daß im TextArea ein Text ausgegeben wird TextArea ta3 = new TextArea("mit Text");.

Der vierte Constructor TextArea ta4 = new TextArea("mit Text und Zeilen/Spalten",7,14); ist eine Mischung aus dem zweiten und dritten Constructor. Es wird ein Text ausgegeben und bestimmt, wie groß das TextArea sein soll.

Der fünfte Constructor hat zusätzlich zum vierten noch die Option, ob und welche Scrollbars angezeigt werden sollen TextArea ta5 = new TextArea("Text, Zeilen, Spalten, Scrollbar", 3,9,Scrollbar.VERTICAL);. Die Variablen können über die Indexvariable der Klasse java.awt.Scrollbar angeben werden bzw. direkt über einen Integer-Wert (0 oder 1).

 
weiter:
zurück:
  TextField
  List
  Seitenanfang © 1999-2001  Brit Schröter