aboutsummaryrefslogtreecommitdiff
path: root/libjava/java/awt/TextComponent.java
diff options
context:
space:
mode:
authorTom Tromey <tromey@redhat.com>2002-01-23 00:07:39 +0000
committerTom Tromey <tromey@gcc.gnu.org>2002-01-23 00:07:39 +0000
commit956e776dd245fe24a7d9586451e9f3d6ae8efa07 (patch)
tree99f00b9ed0ddb5e870f2d0e8cdb1cdd2e918bc44 /libjava/java/awt/TextComponent.java
parentd0c9db30790251ccb1e4af3848aceb41ead63d71 (diff)
downloadgcc-956e776dd245fe24a7d9586451e9f3d6ae8efa07.zip
gcc-956e776dd245fe24a7d9586451e9f3d6ae8efa07.tar.gz
gcc-956e776dd245fe24a7d9586451e9f3d6ae8efa07.tar.bz2
TextField.java: Replaced with Classpath version.
* java/awt/TextField.java: Replaced with Classpath version. * java/awt/TextArea.java: Replaced with Classpath version. * java/awt/TextComponent.java: Replaced with Classpath version. From-SVN: r49113
Diffstat (limited to 'libjava/java/awt/TextComponent.java')
-rw-r--r--libjava/java/awt/TextComponent.java444
1 files changed, 409 insertions, 35 deletions
diff --git a/libjava/java/awt/TextComponent.java b/libjava/java/awt/TextComponent.java
index 0836b5f..a90cb80 100644
--- a/libjava/java/awt/TextComponent.java
+++ b/libjava/java/awt/TextComponent.java
@@ -1,51 +1,425 @@
-/* Copyright (C) 1999, 2001 Free Software Foundation
+/* TextComponent.java -- Widgets for entering text
+ Copyright (C) 1999 Free Software Foundation, Inc.
- This file is part of libjava.
+This file is part of GNU Classpath.
+
+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
+the Free Software Foundation; either version 2, or (at your option)
+any later version.
+
+GNU Classpath is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+General Public License for more details.
+
+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
+Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
+02111-1307 USA.
+
+Linking this library statically or dynamically with other modules is
+making a combined work based on this library. Thus, the terms and
+conditions of the GNU General Public License cover the whole
+combination.
+
+As a special exception, the copyright holders of this library give you
+permission to link this library with independent modules to produce an
+executable, regardless of the license terms of these independent
+modules, and to copy and distribute the resulting executable under
+terms of your choice, provided that you also meet, for each linked
+independent module, the terms and conditions of the license of that
+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
+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
+exception statement from your version. */
-This software is copyrighted work licensed under the terms of the
-Libjava License. Please consult the file "LIBJAVA_LICENSE" for
-details. */
package java.awt;
-import java.awt.event.*;
+import java.awt.event.TextEvent;
+import java.awt.event.TextListener;
import java.awt.peer.TextComponentPeer;
+import java.awt.peer.ComponentPeer;
+
+/**
+ * This class provides common functionality for widgets than
+ * contain text.
+ *
+ * @author Aaron M. Renn (arenn@urbanophile.com)
+ */
+public class TextComponent extends Component implements java.io.Serializable
+{
+
+/*
+ * Static Variables
+ */
+
+// Constant for serialization
+private static final long serialVersionUID = -2214773872412987419L;
+
+/*
+ * Instance Variables
+ */
+
+/**
+ * @serial Indicates whether or not this component is editable.
+ */
+private boolean editable;
+
+/**
+ * @serial The starting position of the selected text region.
+ */
+private int selectionStart;
+
+/**
+ * @serial The ending position of the selected text region.
+ */
+private int selectionEnd;
-/* A very incomplete placeholder. */
+/**
+ * @serial The text in the component
+ */
+private String text;
-public class TextComponent extends Component
+/**
+ * A list of listeners that will receive events from this object.
+ */
+protected transient TextListener textListener;
+
+/*************************************************************************/
+
+/*
+ * Constructors
+ */
+
+TextComponent(String text)
{
- protected TextListener textListener;
+ this.text = text;
+}
- char[] buffer;
- int length;
- int caretPosition;
+/*************************************************************************/
- public synchronized void addTextListener (TextListener listener)
- {
- textListener = AWTEventMulticaster.add (textListener, listener);
- }
+/*
+ * Instance Methods
+ */
- public synchronized String getText ()
- { return new String(buffer, 0, length); }
+/**
+ * Returns the text in this component
+ *
+ * @return The text in this component.
+ */
+public synchronized String
+getText()
+{
+ TextComponentPeer tcp = (TextComponentPeer)getPeer();
+ if (tcp != null)
+ text = tcp.getText();
- public synchronized void setText (String text)
- {
- length = text.length();
- if (buffer == null || buffer.length < length)
- buffer = new char[length];
- text.getChars(0, length, buffer, 0);
- }
+ return(text);
+}
- public int getCaretPosition () { return caretPosition; }
+/*************************************************************************/
- public void setCaretPosition (int pos)
- {
- caretPosition = pos;
- if (peer != null)
- {
- TextComponentPeer t = (TextComponentPeer) peer;
- t.setCaretPosition (pos);
- }
- }
+/**
+ * Sets the text in this component to the specified string.
+ *
+ * @param text The new text for this component.
+ */
+public synchronized void
+setText(String text)
+{
+ if (text == null)
+ text = "";
+
+ this.text = text;
+
+ TextComponentPeer tcp = (TextComponentPeer)getPeer();
+ if (tcp != null)
+ tcp.setText(text);
+}
+
+/*************************************************************************/
+
+/**
+ * Returns a string that contains the text that is currently selected.
+ *
+ * @return The currently selected text region.
+ */
+public synchronized String
+getSelectedText()
+{
+ String alltext = getText();
+ int start = getSelectionStart();
+ int end = getSelectionEnd();
+
+ return(alltext.substring(start, end));
}
+
+/*************************************************************************/
+
+/**
+ * Returns the starting position of the selected text region.
+ * // FIXME: What is returned if there is no selected text?
+ *
+ * @return The starting position of the selected text region.
+ */
+public synchronized int
+getSelectionStart()
+{
+ TextComponentPeer tcp = (TextComponentPeer)getPeer();
+ if (tcp != null)
+ selectionStart = tcp.getSelectionStart();
+
+ return(selectionStart);
+}
+
+/*************************************************************************/
+
+/**
+ * Sets the starting position of the selected region to the
+ * specified value. If the specified value is out of range, then it
+ * will be silently changed to the nearest legal value.
+ *
+ * @param selectionStart The new start position for selected text.
+ */
+public synchronized void
+setSelectionStart(int selectionStart)
+{
+ select(selectionStart, getSelectionEnd());
+}
+
+/*************************************************************************/
+
+/**
+ * Returns the ending position of the selected text region.
+ * // FIXME: What is returned if there is no selected text.
+ *
+ * @return The ending position of the selected text region.
+ */
+public synchronized int
+getSelectionEnd()
+{
+ TextComponentPeer tcp = (TextComponentPeer)getPeer();
+ if (tcp != null)
+ selectionEnd = tcp.getSelectionEnd();
+
+ return(selectionEnd);
+}
+
+/*************************************************************************/
+
+/**
+ * Sets the ending position of the selected region to the
+ * specified value. If the specified value is out of range, then it
+ * will be silently changed to the nearest legal value.
+ *
+ * @param selectionEnd The new start position for selected text.
+ */
+public synchronized void
+setSelectionEnd(int selectionEnd)
+{
+ select(getSelectionStart(), selectionEnd);
+}
+
+/*************************************************************************/
+
+/**
+ * This method sets the selected text range to the text between the
+ * specified start and end positions. Illegal values for these
+ * positions are silently fixed.
+ *
+ * @param startSelection The new start position for the selected text.
+ * @param endSelection The new end position for the selected text.
+ */
+public synchronized void
+select(int selectionStart, int endSelection)
+{
+ if (selectionStart < 0)
+ selectionStart = 0;
+
+ if (selectionStart > getText().length())
+ selectionStart = text.length();
+
+ if (selectionEnd > text.length())
+ selectionEnd = text.length();
+
+ if (selectionStart > getSelectionEnd())
+ selectionStart = selectionEnd;
+
+ this.selectionStart = selectionStart;
+ this.selectionEnd = selectionEnd;
+
+ TextComponentPeer tcp = (TextComponentPeer)getPeer();
+ if (tcp != null)
+ tcp.select(selectionStart, selectionEnd);
+}
+
+/*************************************************************************/
+
+/**
+ * Selects all of the text in the component.
+ */
+public synchronized void
+selectAll()
+{
+ select(0, getText().length());
+}
+
+/*************************************************************************/
+
+/**
+ * Returns the current caret position in the text.
+ *
+ * @return The caret position in the text.
+ */
+public synchronized int
+getCaretPosition()
+{
+ TextComponentPeer tcp = (TextComponentPeer)getPeer();
+ if (tcp != null)
+ return(tcp.getCaretPosition());
+ else
+ return(0);
+}
+
+/*************************************************************************/
+
+/**
+ * Sets the caret position to the specified value.
+ *
+ * @param caretPosition The new caret position.
+ */
+public synchronized void
+setCaretPosition(int caretPosition)
+{
+ TextComponentPeer tcp = (TextComponentPeer)getPeer();
+ if (tcp != null)
+ tcp.setCaretPosition(caretPosition);
+}
+
+/*************************************************************************/
+
+/**
+ * Tests whether or not this component's text can be edited.
+ *
+ * @return <code>true</code> if the text can be edited, <code>false</code>
+ * otherwise.
+ */
+public boolean
+isEditable()
+{
+ return(editable);
+}
+
+/*************************************************************************/
+
+/**
+ * Sets whether or not this component's text can be edited.
+ *
+ * @param editable <code>true</code> to enable editing of the text,
+ * <code>false</code> to disable it.
+ */
+public synchronized void
+setEditable(boolean editable)
+{
+ this.editable = editable;
+
+ TextComponentPeer tcp = (TextComponentPeer)getPeer();
+ if (tcp != null)
+ tcp.setEditable(editable);
+}
+
+/*************************************************************************/
+
+/**
+ * Notifies the component that it should destroy its native peer.
+ */
+public void
+removeNotify()
+{
+ super.removeNotify();
+}
+
+/*************************************************************************/
+
+/**
+ * Adds a new listener to the list of text listeners for this
+ * component.
+ *
+ * @param listener The listener to be added.
+ */
+public synchronized void
+addTextListener(TextListener listener)
+{
+ textListener = AWTEventMulticaster.add(textListener, listener);
+
+ enableEvents(AWTEvent.TEXT_EVENT_MASK);
+}
+
+/*************************************************************************/
+
+/**
+ * Removes the specified listener from the list of listeners
+ * for this component.
+ *
+ * @param listener The listener to remove.
+ */
+public synchronized void
+removeTextListener(TextListener listener)
+{
+ textListener = AWTEventMulticaster.remove(textListener, listener);
+}
+
+/*************************************************************************/
+
+/**
+ * Processes the specified event for this component. Text events are
+ * processed by calling the <code>processTextEvent()</code> method.
+ * All other events are passed to the superclass method.
+ *
+ * @param event The event to process.
+ */
+protected void
+processEvent(AWTEvent event)
+{
+ if (event instanceof TextEvent)
+ processTextEvent((TextEvent)event);
+ else
+ super.processEvent(event);
+}
+
+/*************************************************************************/
+
+/**
+ * Processes the specified text event by dispatching it to any listeners
+ * that are registered. Note that this method will only be called
+ * if text event's are enabled. This will be true if there are any
+ * registered listeners, or if the event has been specifically
+ * enabled using <code>enableEvents()</code>.
+ *
+ * @param event The text event to process.
+ */
+protected void
+processTextEvent(TextEvent event)
+{
+ if (textListener != null)
+ textListener.textValueChanged(event);
+}
+
+/*************************************************************************/
+
+/**
+ * Returns a debugging string.
+ *
+ * @return A debugging string.
+ */
+protected String
+paramString()
+{
+ return(getClass().getName() + "(text=" + getText() + ")");
+}
+
+} // class TextComponent
+