java.awt.peer.TextComponentPeer Java Examples

/**
 * Sets the position of the text insertion caret.
 * The caret position is constrained to be between 0
 * and the last character of the text, inclusive.
 * If the passed-in value is greater than this range,
 * the value is set to the last character (or 0 if
 * the <code>TextComponent</code> contains no text)
 * and no error is returned.  If the passed-in value is
 * less than 0, an <code>IllegalArgumentException</code>
 * is thrown.
 *
 * @param        position the position of the text insertion caret
 * @exception    IllegalArgumentException if <code>position</code>
 *               is less than zero
 * @since        JDK1.1
 */
public synchronized void setCaretPosition(int position) {
    if (position < 0) {
        throw new IllegalArgumentException("position less than zero.");
    }

    int maxposition = getText().length();
    if (position > maxposition) {
        position = maxposition;
    }

    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        peer.setCaretPosition(position);
    } else {
        select(position, position);
    }
}
 

/**
 * Sets the position of the text insertion caret.
 * The caret position is constrained to be between 0
 * and the last character of the text, inclusive.
 * If the passed-in value is greater than this range,
 * the value is set to the last character (or 0 if
 * the <code>TextComponent</code> contains no text)
 * and no error is returned.  If the passed-in value is
 * less than 0, an <code>IllegalArgumentException</code>
 * is thrown.
 *
 * @param        position the position of the text insertion caret
 * @exception    IllegalArgumentException if <code>position</code>
 *               is less than zero
 * @since        JDK1.1
 */
public synchronized void setCaretPosition(int position) {
    if (position < 0) {
        throw new IllegalArgumentException("position less than zero.");
    }

    int maxposition = getText().length();
    if (position > maxposition) {
        position = maxposition;
    }

    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        peer.setCaretPosition(position);
    } else {
        select(position, position);
    }
}
 

/**
 * Writes default serializable fields to stream.  Writes
 * a list of serializable TextListener(s) as optional data.
 * The non-serializable TextListener(s) are detected and
 * no attempt is made to serialize them.
 *
 * @serialData Null terminated sequence of zero or more pairs.
 *             A pair consists of a String and Object.
 *             The String indicates the type of object and
 *             is one of the following :
 *             textListenerK indicating and TextListener object.
 *
 * @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
 * @see java.awt.Component#textListenerK
 */
private void writeObject(java.io.ObjectOutputStream s)
  throws IOException
{
    // Serialization support.  Since the value of the fields
    // selectionStart, selectionEnd, and text aren't necessarily
    // up to date, we sync them up with the peer before serializing.
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        text = peer.getText();
        selectionStart = peer.getSelectionStart();
        selectionEnd = peer.getSelectionEnd();
    }

    s.defaultWriteObject();

    AWTEventMulticaster.save(s, textListenerK, textListener);
    s.writeObject(null);
}
 

/**
 * Returns the position of the text insertion caret.
 * The caret position is constrained to be between 0
 * and the last character of the text, inclusive.
 * If the text or caret have not been set, the default
 * caret position is 0.
 *
 * @return       the position of the text insertion caret
 * @see #setCaretPosition(int)
 * @since        JDK1.1
 */
public synchronized int getCaretPosition() {
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    int position = 0;

    if (peer != null) {
        position = peer.getCaretPosition();
    } else {
        position = selectionStart;
    }
    int maxposition = getText().length();
    if (position > maxposition) {
        position = maxposition;
    }
    return position;
}
 

/**
 * Sets the position of the text insertion caret.
 * The caret position is constrained to be between 0
 * and the last character of the text, inclusive.
 * If the passed-in value is greater than this range,
 * the value is set to the last character (or 0 if
 * the <code>TextComponent</code> contains no text)
 * and no error is returned.  If the passed-in value is
 * less than 0, an <code>IllegalArgumentException</code>
 * is thrown.
 *
 * @param        position the position of the text insertion caret
 * @exception    IllegalArgumentException if <code>position</code>
 *               is less than zero
 * @since        JDK1.1
 */
public synchronized void setCaretPosition(int position) {
    if (position < 0) {
        throw new IllegalArgumentException("position less than zero.");
    }

    int maxposition = getText().length();
    if (position > maxposition) {
        position = maxposition;
    }

    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        peer.setCaretPosition(position);
    } else {
        select(position, position);
    }
}
 

/**
 * Writes default serializable fields to stream.  Writes
 * a list of serializable TextListener(s) as optional data.
 * The non-serializable TextListener(s) are detected and
 * no attempt is made to serialize them.
 *
 * @serialData Null terminated sequence of zero or more pairs.
 *             A pair consists of a String and Object.
 *             The String indicates the type of object and
 *             is one of the following :
 *             textListenerK indicating and TextListener object.
 *
 * @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
 * @see java.awt.Component#textListenerK
 */
private void writeObject(java.io.ObjectOutputStream s)
  throws IOException
{
    // Serialization support.  Since the value of the fields
    // selectionStart, selectionEnd, and text aren't necessarily
    // up to date, we sync them up with the peer before serializing.
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        text = peer.getText();
        selectionStart = peer.getSelectionStart();
        selectionEnd = peer.getSelectionEnd();
    }

    s.defaultWriteObject();

    AWTEventMulticaster.save(s, textListenerK, textListener);
    s.writeObject(null);
}
 

/**
 * Writes default serializable fields to stream.  Writes
 * a list of serializable TextListener(s) as optional data.
 * The non-serializable TextListener(s) are detected and
 * no attempt is made to serialize them.
 *
 * @serialData Null terminated sequence of zero or more pairs.
 *             A pair consists of a String and Object.
 *             The String indicates the type of object and
 *             is one of the following :
 *             textListenerK indicating and TextListener object.
 *
 * @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
 * @see java.awt.Component#textListenerK
 */
private void writeObject(java.io.ObjectOutputStream s)
  throws IOException
{
    // Serialization support.  Since the value of the fields
    // selectionStart, selectionEnd, and text aren't necessarily
    // up to date, we sync them up with the peer before serializing.
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        text = peer.getText();
        selectionStart = peer.getSelectionStart();
        selectionEnd = peer.getSelectionEnd();
    }

    s.defaultWriteObject();

    AWTEventMulticaster.save(s, textListenerK, textListener);
    s.writeObject(null);
}
 

/**
 * Returns the position of the text insertion caret.
 * The caret position is constrained to be between 0
 * and the last character of the text, inclusive.
 * If the text or caret have not been set, the default
 * caret position is 0.
 *
 * @return       the position of the text insertion caret
 * @see #setCaretPosition(int)
 * @since        JDK1.1
 */
public synchronized int getCaretPosition() {
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    int position = 0;

    if (peer != null) {
        position = peer.getCaretPosition();
    } else {
        position = selectionStart;
    }
    int maxposition = getText().length();
    if (position > maxposition) {
        position = maxposition;
    }
    return position;
}
 

/**
 * Writes default serializable fields to stream.  Writes
 * a list of serializable TextListener(s) as optional data.
 * The non-serializable TextListener(s) are detected and
 * no attempt is made to serialize them.
 *
 * @serialData Null terminated sequence of zero or more pairs.
 *             A pair consists of a String and Object.
 *             The String indicates the type of object and
 *             is one of the following :
 *             textListenerK indicating and TextListener object.
 *
 * @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
 * @see java.awt.Component#textListenerK
 */
private void writeObject(java.io.ObjectOutputStream s)
  throws IOException
{
    // Serialization support.  Since the value of the fields
    // selectionStart, selectionEnd, and text aren't necessarily
    // up to date, we sync them up with the peer before serializing.
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        text = peer.getText();
        selectionStart = peer.getSelectionStart();
        selectionEnd = peer.getSelectionEnd();
    }

    s.defaultWriteObject();

    AWTEventMulticaster.save(s, textListenerK, textListener);
    s.writeObject(null);
}
 

/**
 * Writes default serializable fields to stream.  Writes
 * a list of serializable TextListener(s) as optional data.
 * The non-serializable TextListener(s) are detected and
 * no attempt is made to serialize them.
 *
 * @serialData Null terminated sequence of zero or more pairs.
 *             A pair consists of a String and Object.
 *             The String indicates the type of object and
 *             is one of the following :
 *             textListenerK indicating and TextListener object.
 *
 * @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
 * @see java.awt.Component#textListenerK
 */
private void writeObject(java.io.ObjectOutputStream s)
  throws IOException
{
    // Serialization support.  Since the value of the fields
    // selectionStart, selectionEnd, and text aren't necessarily
    // up to date, we sync them up with the peer before serializing.
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        text = peer.getText();
        selectionStart = peer.getSelectionStart();
        selectionEnd = peer.getSelectionEnd();
    }

    s.defaultWriteObject();

    AWTEventMulticaster.save(s, textListenerK, textListener);
    s.writeObject(null);
}
 

/**
 * Returns the position of the text insertion caret.
 * The caret position is constrained to be between 0
 * and the last character of the text, inclusive.
 * If the text or caret have not been set, the default
 * caret position is 0.
 *
 * @return       the position of the text insertion caret
 * @see #setCaretPosition(int)
 * @since        JDK1.1
 */
public synchronized int getCaretPosition() {
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    int position = 0;

    if (peer != null) {
        position = peer.getCaretPosition();
    } else {
        position = selectionStart;
    }
    int maxposition = getText().length();
    if (position > maxposition) {
        position = maxposition;
    }
    return position;
}
 

/**
 * Writes default serializable fields to stream.  Writes
 * a list of serializable TextListener(s) as optional data.
 * The non-serializable TextListener(s) are detected and
 * no attempt is made to serialize them.
 *
 * @serialData Null terminated sequence of zero or more pairs.
 *             A pair consists of a String and Object.
 *             The String indicates the type of object and
 *             is one of the following :
 *             textListenerK indicating and TextListener object.
 *
 * @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
 * @see java.awt.Component#textListenerK
 */
private void writeObject(java.io.ObjectOutputStream s)
  throws IOException
{
    // Serialization support.  Since the value of the fields
    // selectionStart, selectionEnd, and text aren't necessarily
    // up to date, we sync them up with the peer before serializing.
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        text = peer.getText();
        selectionStart = peer.getSelectionStart();
        selectionEnd = peer.getSelectionEnd();
    }

    s.defaultWriteObject();

    AWTEventMulticaster.save(s, textListenerK, textListener);
    s.writeObject(null);
}
 

/**
 * Sets the position of the text insertion caret.
 * The caret position is constrained to be between 0
 * and the last character of the text, inclusive.
 * If the passed-in value is greater than this range,
 * the value is set to the last character (or 0 if
 * the <code>TextComponent</code> contains no text)
 * and no error is returned.  If the passed-in value is
 * less than 0, an <code>IllegalArgumentException</code>
 * is thrown.
 *
 * @param        position the position of the text insertion caret
 * @exception    IllegalArgumentException if <code>position</code>
 *               is less than zero
 * @since        JDK1.1
 */
public synchronized void setCaretPosition(int position) {
    if (position < 0) {
        throw new IllegalArgumentException("position less than zero.");
    }

    int maxposition = getText().length();
    if (position > maxposition) {
        position = maxposition;
    }

    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        peer.setCaretPosition(position);
    } else {
        select(position, position);
    }
}
 

/**
 * Writes default serializable fields to stream.  Writes
 * a list of serializable TextListener(s) as optional data.
 * The non-serializable TextListener(s) are detected and
 * no attempt is made to serialize them.
 *
 * @serialData Null terminated sequence of zero or more pairs.
 *             A pair consists of a String and Object.
 *             The String indicates the type of object and
 *             is one of the following :
 *             textListenerK indicating and TextListener object.
 *
 * @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
 * @see java.awt.Component#textListenerK
 */
private void writeObject(java.io.ObjectOutputStream s)
  throws IOException
{
    // Serialization support.  Since the value of the fields
    // selectionStart, selectionEnd, and text aren't necessarily
    // up to date, we sync them up with the peer before serializing.
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        text = peer.getText();
        selectionStart = peer.getSelectionStart();
        selectionEnd = peer.getSelectionEnd();
    }

    s.defaultWriteObject();

    AWTEventMulticaster.save(s, textListenerK, textListener);
    s.writeObject(null);
}
 

/**
 * Sets the position of the text insertion caret.
 * The caret position is constrained to be between 0
 * and the last character of the text, inclusive.
 * If the passed-in value is greater than this range,
 * the value is set to the last character (or 0 if
 * the {@code TextComponent} contains no text)
 * and no error is returned.  If the passed-in value is
 * less than 0, an {@code IllegalArgumentException}
 * is thrown.
 *
 * @param        position the position of the text insertion caret
 * @exception    IllegalArgumentException if {@code position}
 *               is less than zero
 * @since        1.1
 */
public synchronized void setCaretPosition(int position) {
    if (position < 0) {
        throw new IllegalArgumentException("position less than zero.");
    }

    int maxposition = getText().length();
    if (position > maxposition) {
        position = maxposition;
    }

    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        peer.setCaretPosition(position);
    } else {
        select(position, position);
    }
}
 

/**
 * Sets the position of the text insertion caret.
 * The caret position is constrained to be between 0
 * and the last character of the text, inclusive.
 * If the passed-in value is greater than this range,
 * the value is set to the last character (or 0 if
 * the <code>TextComponent</code> contains no text)
 * and no error is returned.  If the passed-in value is
 * less than 0, an <code>IllegalArgumentException</code>
 * is thrown.
 *
 * @param        position the position of the text insertion caret
 * @exception    IllegalArgumentException if <code>position</code>
 *               is less than zero
 * @since        JDK1.1
 */
public synchronized void setCaretPosition(int position) {
    if (position < 0) {
        throw new IllegalArgumentException("position less than zero.");
    }

    int maxposition = getText().length();
    if (position > maxposition) {
        position = maxposition;
    }

    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        peer.setCaretPosition(position);
    } else {
        select(position, position);
    }
}
 

/**
 * Writes default serializable fields to stream.  Writes
 * a list of serializable TextListener(s) as optional data.
 * The non-serializable TextListener(s) are detected and
 * no attempt is made to serialize them.
 *
 * @serialData Null terminated sequence of zero or more pairs.
 *             A pair consists of a String and Object.
 *             The String indicates the type of object and
 *             is one of the following :
 *             textListenerK indicating and TextListener object.
 *
 * @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
 * @see java.awt.Component#textListenerK
 */
private void writeObject(java.io.ObjectOutputStream s)
  throws IOException
{
    // Serialization support.  Since the value of the fields
    // selectionStart, selectionEnd, and text aren't necessarily
    // up to date, we sync them up with the peer before serializing.
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        text = peer.getText();
        selectionStart = peer.getSelectionStart();
        selectionEnd = peer.getSelectionEnd();
    }

    s.defaultWriteObject();

    AWTEventMulticaster.save(s, textListenerK, textListener);
    s.writeObject(null);
}
 

/**
 * Sets the position of the text insertion caret.
 * The caret position is constrained to be between 0
 * and the last character of the text, inclusive.
 * If the passed-in value is greater than this range,
 * the value is set to the last character (or 0 if
 * the <code>TextComponent</code> contains no text)
 * and no error is returned.  If the passed-in value is
 * less than 0, an <code>IllegalArgumentException</code>
 * is thrown.
 *
 * @param        position the position of the text insertion caret
 * @exception    IllegalArgumentException if <code>position</code>
 *               is less than zero
 * @since        JDK1.1
 */
public synchronized void setCaretPosition(int position) {
    if (position < 0) {
        throw new IllegalArgumentException("position less than zero.");
    }

    int maxposition = getText().length();
    if (position > maxposition) {
        position = maxposition;
    }

    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        peer.setCaretPosition(position);
    } else {
        select(position, position);
    }
}
 

/**
 * Sets the position of the text insertion caret.
 * The caret position is constrained to be between 0
 * and the last character of the text, inclusive.
 * If the passed-in value is greater than this range,
 * the value is set to the last character (or 0 if
 * the <code>TextComponent</code> contains no text)
 * and no error is returned.  If the passed-in value is
 * less than 0, an <code>IllegalArgumentException</code>
 * is thrown.
 *
 * @param        position the position of the text insertion caret
 * @exception    IllegalArgumentException if <code>position</code>
 *               is less than zero
 * @since        JDK1.1
 */
public synchronized void setCaretPosition(int position) {
    if (position < 0) {
        throw new IllegalArgumentException("position less than zero.");
    }

    int maxposition = getText().length();
    if (position > maxposition) {
        position = maxposition;
    }

    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        peer.setCaretPosition(position);
    } else {
        select(position, position);
    }
}
 

/**
 * Gets the end position of the selected text in
 * this text component.
 * @return      the end position of the selected text
 * @see         java.awt.TextComponent#setSelectionEnd
 * @see         java.awt.TextComponent#getSelectionStart
 */
public synchronized int getSelectionEnd() {
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        selectionEnd = peer.getSelectionEnd();
    }
    return selectionEnd;
}
 

/**
 * Gets the end position of the selected text in
 * this text component.
 * @return      the end position of the selected text
 * @see         java.awt.TextComponent#setSelectionEnd
 * @see         java.awt.TextComponent#getSelectionStart
 */
public synchronized int getSelectionEnd() {
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        selectionEnd = peer.getSelectionEnd();
    }
    return selectionEnd;
}
 

/**
 * Gets the start position of the selected text in
 * this text component.
 * @return      the start position of the selected text
 * @see         java.awt.TextComponent#setSelectionStart
 * @see         java.awt.TextComponent#getSelectionEnd
 */
public synchronized int getSelectionStart() {
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        selectionStart = peer.getSelectionStart();
    }
    return selectionStart;
}
 

/**
 * Removes the <code>TextComponent</code>'s peer.
 * The peer allows us to modify the appearance of the
 * <code>TextComponent</code> without changing its
 * functionality.
 */
public void removeNotify() {
    synchronized (getTreeLock()) {
        TextComponentPeer peer = (TextComponentPeer)this.peer;
        if (peer != null) {
            text = peer.getText();
            selectionStart = peer.getSelectionStart();
            selectionEnd = peer.getSelectionEnd();
        }
        super.removeNotify();
    }
}
 

/**
 * Gets the end position of the selected text in
 * this text component.
 * @return      the end position of the selected text
 * @see         java.awt.TextComponent#setSelectionEnd
 * @see         java.awt.TextComponent#getSelectionStart
 */
public synchronized int getSelectionEnd() {
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        selectionEnd = peer.getSelectionEnd();
    }
    return selectionEnd;
}
 

/**
 * Gets the end position of the selected text in
 * this text component.
 * @return      the end position of the selected text
 * @see         java.awt.TextComponent#setSelectionEnd
 * @see         java.awt.TextComponent#getSelectionStart
 */
public synchronized int getSelectionEnd() {
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        selectionEnd = peer.getSelectionEnd();
    }
    return selectionEnd;
}
 

/**
 * Selects all the text in this text component.
 * @see        java.awt.TextComponent#select
 */
public synchronized void selectAll() {
    this.selectionStart = 0;
    this.selectionEnd = getText().length();

    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        peer.select(selectionStart, selectionEnd);
    }
}
 

/**
 * Sets the text that is presented by this
 * text component to be the specified text.
 * @param       t   the new text;
 *                  if this parameter is <code>null</code> then
 *                  the text is set to the empty string ""
 * @see         java.awt.TextComponent#getText
 */
public synchronized void setText(String t) {
    boolean skipTextEvent = (text == null || text.isEmpty())
            && (t == null || t.isEmpty());
    text = (t != null) ? t : "";
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    // Please note that we do not want to post an event
    // if TextArea.setText() or TextField.setText() replaces an empty text
    // by an empty text, that is, if component's text remains unchanged.
    if (peer != null && !skipTextEvent) {
        peer.setText(text);
    }
}
 

/**
 * Gets the end position of the selected text in
 * this text component.
 * @return      the end position of the selected text
 * @see         java.awt.TextComponent#setSelectionEnd
 * @see         java.awt.TextComponent#getSelectionStart
 */
public synchronized int getSelectionEnd() {
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        selectionEnd = peer.getSelectionEnd();
    }
    return selectionEnd;
}
 

/**
 * Gets the start position of the selected text in
 * this text component.
 * @return      the start position of the selected text
 * @see         java.awt.TextComponent#setSelectionStart
 * @see         java.awt.TextComponent#getSelectionEnd
 */
public synchronized int getSelectionStart() {
    TextComponentPeer peer = (TextComponentPeer)this.peer;
    if (peer != null) {
        selectionStart = peer.getSelectionStart();
    }
    return selectionStart;
}
 

/**
 * Removes the <code>TextComponent</code>'s peer.
 * The peer allows us to modify the appearance of the
 * <code>TextComponent</code> without changing its
 * functionality.
 */
public void removeNotify() {
    synchronized (getTreeLock()) {
        TextComponentPeer peer = (TextComponentPeer)this.peer;
        if (peer != null) {
            text = peer.getText();
            selectionStart = peer.getSelectionStart();
            selectionEnd = peer.getSelectionEnd();
        }
        super.removeNotify();
    }
}