Class DocumentFilter.FilterBypass

java.lang.Object
javax.swing.text.DocumentFilter.FilterBypass
Enclosing class:
DocumentFilter
public abstract static class DocumentFilter.FilterBypass extends Object
Used as a way to circumvent calling back into the Document to change it. Document implementations that wish to support a DocumentFilter must provide an implementation that will not callback into the DocumentFilter when the following methods are invoked from the DocumentFilter.
Since:
1.4

  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    protected
    FilterBypass()
    Constructor for subclasses to call.

  • Method Summary

    Modifier and Type
    Method
    Description
    abstract Document
    getDocument()
    Returns the Document the mutation is occurring on.
    abstract void
    insertString(int offset, String string, AttributeSet attr)
    Inserts the specified text, bypassing the DocumentFilter.
    abstract void
    remove(int offset, int length)
    Removes the specified region of text, bypassing the DocumentFilter.
    abstract void
    replace(int offset, int length, String string, AttributeSet attrs)
    Deletes the region of text from offset to offset + length, and replaces it with text.

    Methods declared in class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    clone()
    Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
    boolean
    equals(Object o)
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    getClass()
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    int
    hashCode()
    Answers an integer hash code for the receiver.
    final void
    notify()
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    notifyAll()
    Causes all threads which are waiting on the receiver to be made ready to run.
    String
    toString()
    Answers a string containing a concise, human-readable description of the receiver.
    final void
    wait()
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

  • Constructor Details

    • FilterBypass

      protected FilterBypass()
      Constructor for subclasses to call.

  • Method Details

    • getDocument

      public abstract Document getDocument()
      Returns the Document the mutation is occurring on.
      Returns:
      Document that remove/insertString will operate on

    • remove

      public abstract void remove(int offset, int length) throws BadLocationException
      Removes the specified region of text, bypassing the DocumentFilter.
      Parameters:
      offset - the offset from the beginning >= 0
      length - the number of characters to remove >= 0
      Throws:
      BadLocationException - some portion of the removal range was not a valid part of the document. The location in the exception is the first bad position encountered.

    • insertString

      public abstract void insertString(int offset, String string, AttributeSet attr) throws BadLocationException
      Inserts the specified text, bypassing the DocumentFilter.
      Parameters:
      offset - the offset into the document to insert the content >= 0. All positions that track change at or after the given location will move.
      string - the string to insert
      attr - the attributes to associate with the inserted content. This may be null if there are no attributes.
      Throws:
      BadLocationException - the given insert position is not a valid position within the document

    • replace

      public abstract void replace(int offset, int length, String string, AttributeSet attrs) throws BadLocationException
      Deletes the region of text from offset to offset + length, and replaces it with text.
      Parameters:
      offset - Location in Document
      length - Length of text to delete
      string - Text to insert, null indicates no text to insert
      attrs - AttributeSet indicating attributes of inserted text, null is legal.
      Throws:
      BadLocationException - the given insert is not a valid position within the document