Commit 062732fd by Thomas Fitzsimmons Committed by Thomas Fitzsimmons

TextArea.java: Fix indentation.

2004-01-25  Thomas Fitzsimmons  <fitzsim@redhat.com>

	* java/awt/TextArea.java: Fix indentation.  Flesh out javadocs.
	(getMinimumSize (int, int)): Fix FIXME -- return Dimension (0,0)
	when peer is null.
	(setColumns): Remove FIXME -- peer will retrieve number of
	columns by calling getColumns.
	(setRows): Likewise for number of rows.
	(next_text_number): New field.
	(paramString): Fix param string.
	(generateName): New method.
	(getUniqueLong): New method.

From-SVN: r76577
parent 0058a7d8
2004-01-25 Thomas Fitzsimmons <fitzsim@redhat.com> 2004-01-25 Thomas Fitzsimmons <fitzsim@redhat.com>
* java/awt/TextArea.java: Fix indentation. Flesh out javadocs.
(getMinimumSize (int, int)): Fix FIXME -- return Dimension (0,0)
when peer is null.
(setColumns): Remove FIXME -- peer will retrieve number of
columns by calling getColumns.
(setRows): Likewise for number of rows.
(next_text_number): New field.
(paramString): Fix param string.
(generateName): New method.
(getUniqueLong): New method.
2004-01-25 Thomas Fitzsimmons <fitzsim@redhat.com>
* gnu/java/awt/peer/gtk/GtkToolkit.java (checkImage): Inform * gnu/java/awt/peer/gtk/GtkToolkit.java (checkImage): Inform
image observer of image loading status. image observer of image loading status.
(getImage (String)): Start image production. (getImage (String)): Start image production.
......
/* TextArea.java -- A multi-line text entry widget /* TextArea.java -- A multi-line text entry component
Copyright (C) 1999 Free Software Foundation, Inc. Copyright (C) 1999, 2004 Free Software Foundation, Inc.
This file is part of GNU Classpath. This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option) the Free Software Foundation; either version 2, or (at your option)
any later version. any later version.
GNU Classpath is distributed in the hope that it will be useful, but GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details. General Public License for more details.
You should have received a copy of the GNU General Public License You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA. 02111-1307 USA.
Linking this library statically or dynamically with other modules is Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole conditions of the GNU General Public License cover the whole
combination. combination.
As a special exception, the copyright holders of this library give you As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this obligated to do so. If you do not wish to do so, delete this
exception statement from your version. */ exception statement from your version. */
package java.awt; package java.awt;
import java.awt.peer.ComponentPeer; import java.awt.peer.ComponentPeer;
import java.awt.peer.TextAreaPeer; import java.awt.peer.TextAreaPeer;
/** /**
* This implements a multi-line text entry widget. * A TextArea is a text component capable of displaying multiple lines
* of user-editable text. A TextArea handles its own scrolling and
* can display vertical and horizontal scrollbars as navigation aids.
* *
* @author Aaron M. Renn (arenn@urbanophile.com) * @author Aaron M. Renn (arenn@urbanophile.com)
*/ */
public class TextArea extends TextComponent implements java.io.Serializable public class TextArea extends TextComponent implements java.io.Serializable
{ {
/**
/* * Display both horiztonal and vertical scroll bars.
* Static Variables
*/
/**
* Use both horiztonal and vertical scroll bars.
*/ */
public static final int SCROLLBARS_BOTH = 0; public static final int SCROLLBARS_BOTH = 0;
/** /**
* Use vertical scroll bars only. * Display vertical scroll bar only.
*/ */
public static final int SCROLLBARS_VERTICAL_ONLY = 1; public static final int SCROLLBARS_VERTICAL_ONLY = 1;
/** /**
* Use horizatonal scroll bars only. * Display horizatonal scroll bar only.
*/ */
public static final int SCROLLBARS_HORIZONTAL_ONLY = 2; public static final int SCROLLBARS_HORIZONTAL_ONLY = 2;
/** /**
* Use no scrollbars. * Do not display scrollbars.
*/ */
public static final int SCROLLBARS_NONE = 3; public static final int SCROLLBARS_NONE = 3;
// Serialization constant /**
private static final long serialVersionUID = 3692302836626095722L; * Serialization constant.
/*************************************************************************/
/*
* Instance Variables
*/ */
private static final long serialVersionUID = 3692302836626095722L;
/** /**
* @serial The number of columns in this text area. * @serial The number of columns used in this text area's preferred
* and minimum size calculations.
*/ */
private int columns; private int columns;
/** /**
* @serial The number of rows in this text area. * @serial The number of rows used in this text area's preferred and
* minimum size calculations.
*/ */
private int rows; private int rows;
/** /**
* @serial The type of scrollbars to display, which will be one of * @serial The scrollbar display policy. One of SCROLLBARS_BOTH,
* the contstants from this class. * SCROLLBARS_VERTICAL_ONLY, SCROLLBARS_HORIZONTAL_ONLY,
* SCROLLBARS_NONE.
*/ */
private int scrollbarVisibility; private int scrollbarVisibility;
/*************************************************************************/ /*
* The number used to generate the name returned by getName.
/*
* Constructors
*/ */
private static transient long next_text_number = 0;
/** /**
* Initialize a new instance of <code>TextArea</code> that is empty * Initialize a new instance of <code>TextArea</code> that is empty
* and is one row and one column. Both horizontal and vertical * and is one row by one column. Both horizontal and vertical
* scrollbars will be used. * scrollbars will be displayed.
* *
* @exception HeadlessException If GraphicsEnvironment.isHeadless() is true, * @exception HeadlessException If GraphicsEnvironment.isHeadless () is true,
*/ */
public public TextArea ()
TextArea() {
{ this ("", 1, 1, SCROLLBARS_BOTH);
this("", 1, 1, SCROLLBARS_BOTH); }
}
/*************************************************************************/
/** /**
* Initializes a new instance of <code>TextArea</code> that * Initialize a new instance of <code>TextArea</code> that initially
* contains the specified string. Both horizontal and veritcal * contains the specified text. Both horizontal and veritcal
* scrollbars will be used. * scrollbars will be displayed.
* *
* @param text The text to display in this text area. * @param text The text to display in this text area.
* *
* @exception HeadlessException If GraphicsEnvironment.isHeadless() is true, * @exception HeadlessException If GraphicsEnvironment.isHeadless () is true,
*/ */
public public TextArea (String text)
TextArea(String text) {
{ this (text, 1, text.length (), SCROLLBARS_BOTH);
this(text, 1, text.length(), SCROLLBARS_BOTH); }
}
/*************************************************************************/
/** /**
* Initializes a new instance of <code>TextArea</code> that is empty * Initialize a new instance of <code>TextArea</code> that is empty
* and has the specified number of rows and columns. Both * and can display the specified number of rows and columns of text,
* horizontal and vertical scrollbars will be used. * without the need to scroll. Both horizontal and vertical
* scrollbars will be displayed.
* *
* @param rows The number of rows in this text area. * @param rows The number of rows in this text area.
* @param columns The number of columns in this text area. * @param columns The number of columns in this text area.
* *
* @exception HeadlessException If GraphicsEnvironment.isHeadless() is true, * @exception HeadlessException If GraphicsEnvironment.isHeadless () is true,
*/ */
public public TextArea (int rows, int columns)
TextArea(int rows, int columns) {
{ this ("", rows, columns, SCROLLBARS_BOTH);
this("", rows, columns, SCROLLBARS_BOTH); }
}
/*************************************************************************/
/** /**
* Initializes a new instance of <code>TextArea</code> that is the * Initialize a new instance of <code>TextArea</code> that can
* specified size and has the specified text. * display the specified number of rows and columns of text, without
* the need to scroll. The TextArea initially contains the
* specified text.
* *
* @param text The text to display in this text area. * @param text The text to display in this text area.
* @param rows The number of rows in this text area. * @param rows The number of rows in this text area.
* @param columns The number of columns in this text area. * @param columns The number of columns in this text area.
* *
* @exception HeadlessException If GraphicsEnvironment.isHeadless() is true, * @exception HeadlessException If GraphicsEnvironment.isHeadless () is true,
*/ */
public public TextArea (String text, int rows, int columns)
TextArea(String text, int rows, int columns) {
{ this (text, rows, columns, SCROLLBARS_BOTH);
this(text, rows, columns, SCROLLBARS_BOTH); }
}
/*************************************************************************/
/** /**
* Initializes a new instance of <code>TextArea</code> with the * Initialize a new instance of <code>TextArea</code> that initially
* specified values. The scrollbar visibility value must be one * contains the specified text. The TextArea can display the
* of the constants in this class. * specified number of rows and columns of text, without the need to
* scroll. This constructor allows specification of the scroll bar
* display policy.
* *
* @param text The text to display in this text area. * @param text The text to display in this text area.
* @param rows The number of rows in this text area. * @param rows The number of rows in this text area.
* @param columns The number of columns in this text area. * @param columns The number of columns in this text area.
* @param scrollbarVisibility Which scrollbars to display. * @param scrollbarVisibility The scroll bar display policy. One of
* SCROLLBARS_BOTH, SCROLLBARS_VERTICAL_ONLY,
* SCROLLBARS_HORIZONTAL_ONLY, SCROLLBARS_NONE.
* *
* @exception HeadlessException If GraphicsEnvironment.isHeadless() is true, * @exception HeadlessException If GraphicsEnvironment.isHeadless () is true,
*/ */
public public TextArea (String text, int rows, int columns, int scrollbarVisibility)
TextArea(String text, int rows, int columns, int scrollbarVisibility) {
{ super (text);
super(text);
if (GraphicsEnvironment.isHeadless()) if (GraphicsEnvironment.isHeadless ())
throw new HeadlessException (); throw new HeadlessException ();
if ((rows < 1) || (columns < 0)) if (rows < 1 || columns < 0)
throw new IllegalArgumentException("Bad row or column value"); throw new IllegalArgumentException ("Bad row or column value");
if ((scrollbarVisibility != SCROLLBARS_BOTH) && if (scrollbarVisibility != SCROLLBARS_BOTH
(scrollbarVisibility != SCROLLBARS_VERTICAL_ONLY) && && scrollbarVisibility != SCROLLBARS_VERTICAL_ONLY
(scrollbarVisibility != SCROLLBARS_HORIZONTAL_ONLY) && && scrollbarVisibility != SCROLLBARS_HORIZONTAL_ONLY
(scrollbarVisibility != SCROLLBARS_NONE)) && scrollbarVisibility != SCROLLBARS_NONE)
throw new IllegalArgumentException("Bad scrollbar visibility value"); throw new IllegalArgumentException ("Bad scrollbar visibility value");
this.rows = rows; this.rows = rows;
this.columns = columns; this.columns = columns;
this.scrollbarVisibility = scrollbarVisibility; this.scrollbarVisibility = scrollbarVisibility;
} }
/*************************************************************************/
/* /*
* Instance Variables * Instance Variables
*/ */
/** /**
* Returns the number of columns in the field. * Retrieve the number of columns that this text area would prefer
* to display. This value may or may not correspond to the number
* of columns that are actually displayed.
* *
* @return The number of columns in the field. * @return The preferred number of columns.
*/ */
public int public int getColumns ()
getColumns() {
{ return columns;
return(columns); }
}
/*************************************************************************/
/** /**
* Sets the number of columns in this field to the specified value. * Set the preferred number of columns for this text area. This
* method does not cause the number of columns displayed by the text
* area to be updated, if the text area is currently visible.
* *
* @param columns The new number of columns in the field. * @param columns The preferred number of columns.
* *
* @exception IllegalArgumentException If columns is less than zero. * @exception IllegalArgumentException If columns is less than zero.
*/ */
public synchronized void public synchronized void setColumns (int columns)
setColumns(int columns) {
{
if (columns < 0) if (columns < 0)
throw new IllegalArgumentException("Value is less than zero: " + throw new IllegalArgumentException ("Value is less than zero: "
columns); + columns);
this.columns = columns; this.columns = columns;
// FIXME: How to we communicate this to our peer? }
}
/*************************************************************************/
/** /**
* Returns the number of rows in the field. * Retrieve the number of rows that this text area would prefer to
* display. This value may or may not correspond to the number of
* rows that are actually displayed.
* *
* @return The number of rows in the field. * @return The preferred number of rows.
*/ */
public int public int getRows ()
getRows() {
{ return rows;
return(rows); }
}
/*************************************************************************/
/** /**
* Sets the number of rows in this field to the specified value. * Set the preferred number of rows for this text area. This method
* does not cause the number of columns displayed by the text area
* to be updated, if the text area is currently visible.
* *
* @param rows The new number of rows in the field. * @param rows The preferred number of rows.
* *
* @exception IllegalArgumentException If rows is less than zero. * @exception IllegalArgumentException If rows is less than zero.
*/ */
public synchronized void public synchronized void setRows (int rows)
setRows(int rows) {
{
if (rows < 1) if (rows < 1)
throw new IllegalArgumentException("Value is less than one: " + throw new IllegalArgumentException ("Value is less than one: " + rows);
rows);
this.rows = rows; this.rows = rows;
// FIXME: How to we communicate this to our peer? }
}
/*************************************************************************/
/** /**
* Returns the minimum size for this text field. * Retrieve the minimum size for this text area, considering the
* text area's current row and column values. A text area's minimum
* size depends on the number of rows and columns of text it would
* prefer to display, and on the size of the font in which the text
* would be displayed.
* *
* @return The minimum size for this text field. * @return The minimum size for this text field.
*/ */
public Dimension public Dimension getMinimumSize ()
getMinimumSize() {
{ return getMinimumSize (getRows (), getColumns ());
return(getMinimumSize(getRows(), getColumns())); }
}
/*************************************************************************/
/** /**
* Returns the minimum size of a text field with the specified number * Retrieve the minimum size that this text area would have if its
* of rows and columns. * row and column values were equal to those specified. A text
* area's minimum size depends on the number of rows and columns of
* text it would prefer to display, and on the size of the font in
* which the text would be displayed.
* *
* @param rows The number of rows to get the minimum size for. * @param rows The number of rows to use in the minimum size
* @param columns The number of columns to get the minimum size for. * calculation.
* @param columns The number of columns to use in the minimum size
* calculation.
*
* @return The minimum size for this text area.
*/ */
public Dimension public Dimension getMinimumSize (int rows, int columns)
getMinimumSize(int rows, int columns) {
{ TextAreaPeer peer = (TextAreaPeer) getPeer ();
TextAreaPeer tap = (TextAreaPeer)getPeer();
if (tap == null)
return(null); // FIXME: What do we do if there is no peer?
return(tap.getMinimumSize(rows, columns)); // Sun returns Dimension (0,0) in this case.
} if (peer == null)
return new Dimension (0, 0);
/*************************************************************************/ return peer.getMinimumSize (rows, columns);
}
/** /**
* Returns the minimum size for this text field. * Retrieve the minimum size for this text area, considering the
* text area's current row and column values. A text area's minimum
* size depends on the number of rows and columns of text it would
* prefer to display, and on the size of the font in which the text
* would be displayed.
* *
* @return The minimum size for this text field. * @return The minimum size for this text area.
* *
* @deprecated This method is depcreated in favor of * @deprecated This method is deprecated in favor of
* <code>getMinimumSize()</code>. * <code>getMinimumSize ()</code>.
*/ */
public Dimension public Dimension minimumSize ()
minimumSize() {
{ return getMinimumSize (getRows (), getColumns ());
return(getMinimumSize(getRows(), getColumns())); }
}
/*************************************************************************/
/** /**
* Returns the minimum size of a text field with the specified number * Retrieve the minimum size that this text area would have if its
* of rows and columns. * row and column values were equal to those specified. A text
* area's minimum size depends on the number of rows and columns of
* text it would prefer to display, and on the size of the font in
* which the text would be displayed.
* *
* @param rows The number of rows to get the minimum size for. * @param rows The number of rows to use in the minimum size
* @param columns The number of columns to get the minimum size for. * calculation.
* @param columns The number of columns to use in the minimum size
* calculation.
*
* @return The minimum size for this text area.
* *
* @deprecated This method is deprecated in favor of * @deprecated This method is deprecated in favor of
* <code>getMinimumSize(int)</code>. * <code>getMinimumSize (int, int)</code>.
*/ */
public Dimension public Dimension minimumSize (int rows, int columns)
minimumSize(int rows, int columns) {
{ return getMinimumSize (rows, columns);
return(getMinimumSize(rows, columns)); }
}
/*************************************************************************/
/** /**
* Returns the preferred size for this text field. * Retrieve the preferred size for this text area, considering the
* text area's current row and column values. A text area's preferred
* size depends on the number of rows and columns of text it would
* prefer to display, and on the size of the font in which the text
* would be displayed.
* *
* @return The preferred size for this text field. * @return The preferred size for this text field.
*/ */
public Dimension public Dimension getPreferredSize ()
getPreferredSize() {
{ return getPreferredSize (getRows (), getColumns ());
return(getPreferredSize(getRows(), getColumns())); }
}
/*************************************************************************/
/** /**
* Returns the preferred size of a text field with the specified number * Retrieve the preferred size that this text area would have if its
* of rows and columns. * row and column values were equal to those specified. A text
* area's preferred size depends on the number of rows and columns
* of text it would prefer to display, and on the size of the font
* in which the text would be displayed.
*
* @param rows The number of rows to use in the preferred size
* calculation.
* @param columns The number of columns to use in the preferred size
* calculation.
* *
* @param rows The number of rows to get the preferred size for. * @return The preferred size for this text area.
* @param columns The number of columns to get the preferred size for.
*/ */
public Dimension public Dimension getPreferredSize (int rows, int columns)
getPreferredSize(int rows, int columns)
{
TextAreaPeer tap = (TextAreaPeer)getPeer();
if (tap == null)
{ {
// Sun's JDK just seems to return Dimension(0,0) in this case. TextAreaPeer peer = (TextAreaPeer) getPeer ();
// we do the same.
return new Dimension(0, 0);
}
return(tap.getPreferredSize(rows, columns)); // Sun returns Dimension (0,0) in this case.
} if (peer == null)
return new Dimension (0, 0);
/*************************************************************************/ return peer.getPreferredSize (rows, columns);
}
/** /**
* Returns the preferred size for this text field. * Retrieve the preferred size for this text area, considering the
* text area's current row and column values. A text area's preferred
* size depends on the number of rows and columns of text it would
* prefer to display, and on the size of the font in which the text
* would be displayed.
* *
* @return The preferred size for this text field. * @return The preferred size for this text field.
* *
* @deprecated This method is deprecated in favor of * @deprecated This method is deprecated in favor of
* <code>getPreferredSize()</code>. * <code>getPreferredSize ()</code>.
*/ */
public Dimension public Dimension preferredSize ()
preferredSize() {
{ return getPreferredSize (getRows (), getColumns ());
return(getPreferredSize(getRows(), getColumns())); }
}
/*************************************************************************/
/** /**
* Returns the preferred size of a text field with the specified number * Retrieve the preferred size that this text area would have if its
* of rows and columns. * row and column values were equal to those specified. A text
* area's preferred size depends on the number of rows and columns
* of text it would prefer to display, and on the size of the font
* in which the text would be displayed.
*
* @param rows The number of rows to use in the preferred size
* calculation.
* @param columns The number of columns to use in the preferred size
* calculation.
* *
* @param rows The number of rows to get the preferred size for. * @return The preferred size for this text area.
* @param columns The number of columns to get the preferred size for.
* *
* @deprecated This method is deprecated in favor of * @deprecated This method is deprecated in favor of
* <code>getPreferredSize(int)</code>. * <code>getPreferredSize (int, int)</code>.
*/ */
public Dimension public Dimension preferredSize (int rows, int columns)
preferredSize(int rows, int columns) {
{ return getPreferredSize (rows, columns);
return(getPreferredSize(rows, columns)); }
}
/*************************************************************************/
/** /**
* Returns one of the constants from this class indicating which * Retrieve the scroll bar display policy -- one of SCROLLBARS_BOTH,
* types of scrollbars this object uses, if any. * SCROLLBARS_VERTICAL_ONLY, SCROLLBARS_HORIZONTAL_ONLY,
* SCROLLBARS_NONE.
* *
* @return The scrollbar type constant for this object. * @return The current scroll bar display policy.
*/ */
public int public int getScrollbarVisibility ()
getScrollbarVisibility() {
{ return scrollbarVisibility;
return(scrollbarVisibility); }
}
/*************************************************************************/
/** /**
* Notify this object that it should create its native peer. * Notify this object that it should create its native peer.
*/ */
public void public void addNotify ()
addNotify() {
{ if (getPeer () != null)
if (getPeer() != null)
return; return;
setPeer((ComponentPeer)getToolkit().createTextArea(this)); setPeer ((ComponentPeer) getToolkit().createTextArea (this));
} }
/*************************************************************************/
/** /**
* Appends the specified text to the end of the current text. * Append the specified text to the end of the current text.
* *
* @param text The text to append. * @param text The text to append.
*/ */
public void public void append (String str)
append(String str) {
{ TextAreaPeer peer = (TextAreaPeer) getPeer ();
TextAreaPeer tap = (TextAreaPeer)getPeer(); if (peer == null)
if (tap == null)
return; return;
tap.insert(str, tap.getText().length()); peer.insert (str, peer.getText().length ());
} }
/*************************************************************************/
/** /**
* Appends the specified text to the end of the current text. * Append the specified text to the end of the current text.
* *
* @param text The text to append. * @param text The text to append.
* *
* @deprecated This method is deprecated in favor of * @deprecated This method is deprecated in favor of
* <code>append()</code>. * <code>append ()</code>.
*/ */
public void public void appendText (String text)
appendText(String text) {
{ append (text);
append(text); }
}
/*************************************************************************/
/** /**
* Inserts the specified text at the specified location. * Insert the specified text at the specified position. The first
* character in the text area is at position zero.
* *
* @param text The text to insert. * @param text The text to insert.
* @param pos The insert position. * @param pos The position at which to insert text.
*/ */
public void public void insert (String text, int pos)
insert(String text, int pos) {
{ TextAreaPeer peer = (TextAreaPeer) getPeer ();
TextAreaPeer tap = (TextAreaPeer)getPeer(); if (peer == null)
if (tap == null)
return; return;
tap.insert(text, pos); peer.insert (text, pos);
} }
/*************************************************************************/
/** /**
* Inserts the specified text at the specified location. * Insert the specified text at the specified position. The first
* character in the text area is at position zero.
* *
* @param text The text to insert. * @param text The text to insert.
* @param pos The insert position. * @param pos The position at which to insert text.
* *
* @deprecated This method is depcreated in favor of <code>insert()</code>. * @deprecated This method is depcreated in favor of
* <code>insert ()</code>.
*/ */
public void public void insertText (String text, int pos)
insertText(String text, int pos) {
{ insert (text, pos);
insert(text, pos); }
}
/*************************************************************************/
/** /**
* Replaces the text bounded by the specified start and end positions * Replace a range of characters with the specified text. The
* with the specified text. * character at the start position will be replaced, unless start ==
* end. The character at the end posistion will not be replaced.
* The first character in the text area is at position zero. The
* length of the replacement text may differ from the length of the
* text that is replaced.
* *
* @param text The new text for the range. * @param text The new text for the range.
* @param start The start position of the replacement range. * @param start The start position of the replacement range.
* @param end The end position of the replacement range. * @param end The end position of the replacement range.
*/ */
public void public void replaceRange (String text, int start, int end)
replaceRange(String text, int start, int end) {
{ TextAreaPeer peer = (TextAreaPeer) getPeer ();
TextAreaPeer tap = (TextAreaPeer)getPeer(); if (peer == null)
if (tap == null)
return; return;
tap.replaceRange(text, start, end); peer.replaceRange (text, start, end);
} }
/*************************************************************************/
/** /**
* Replaces the text bounded by the specified start and end positions * Replace a range of characters with the specified text. The
* with the specified text. * character at the start position will be replaced, unless start ==
* end. The character at the end posistion will not be replaced.
* The first character in the text area is at position zero. The
* length of the replacement text may differ from the length of the
* text that is replaced.
* *
* @param text The new text for the range. * @param text The new text for the range.
* @param start The start position of the replacement range. * @param start The start position of the replacement range.
* @param end The end position of the replacement range. * @param end The end position of the replacement range.
* *
* @deprecated This method is deprecated in favor of * @deprecated This method is deprecated in favor of
* <code>replaceRange()</code>. * <code>replaceRange ()</code>.
*/ */
public void public void replaceText (String text, int start, int end)
replaceText(String text, int start, int end) {
{ replaceRange (text, start, end);
replaceRange(text, start, end); }
}
/*************************************************************************/
/** /**
* Returns a debugging string for this text area. * Retrieve a debugging string for this text area.
* *
* @return A debugging string for this text area. * @return A debugging string for this text area.
*/ */
protected String protected String paramString ()
paramString() {
{ String sbVisibility = "";
return(getClass().getName() + "(rows=" + getRows() + ",columns=" +
getColumns() + ",scrollbars=" + getScrollbarVisibility() +
")");
}
} // class TextArea switch (scrollbarVisibility)
{
case SCROLLBARS_BOTH:
sbVisibility = "both";
break;
case SCROLLBARS_VERTICAL_ONLY:
sbVisibility = "vertical-only";
break;
case SCROLLBARS_HORIZONTAL_ONLY:
sbVisibility = "horizontal-only";
break;
case SCROLLBARS_NONE:
sbVisibility = "none";
break;
}
String editable = "";
if (isEditable ())
editable = "editable,";
return getName () + "," + getX () + "," + getY () + "," + getWidth ()
+ "x" + getHeight () + "," + "text=" + getText () + "," + editable
+ "selection=" + getSelectionStart () + "-" + getSelectionEnd ()
+ ",rows=" + rows + ",columns=" + columns + ",scrollbarVisibility="
+ sbVisibility;
}
/**
* Generate a unique name for this text area.
*
* @return A unique name for this text area.
*/
String generateName ()
{
return "text" + getUniqueLong ();
}
private static synchronized long getUniqueLong ()
{
return next_text_number++;
}
}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment