Package org.jdesktop.swingx.autocomplete

Class AutoCompleteDocument

  • All Implemented Interfaces:
    javax.swing.text.Document
    Direct Known Subclasses:
    AutoCompleteStyledDocument
    public class AutoCompleteDocument
extends java.lang.Object
implements javax.swing.text.Document
    A document that can be plugged into any JTextComponent to enable automatic completion. It finds and selects matching items using any implementation of the AbstractAutoCompleteAdaptor.

    • Field Detail

      • strictMatching

        protected boolean strictMatching
        true, if only items from the adaptors's list can be entered false, otherwise (selected item might not be in the adaptors's list)

      • delegate

        protected final javax.swing.text.Document delegate

    • Constructor Detail

      • AutoCompleteDocument

        public AutoCompleteDocument​(AbstractAutoCompleteAdaptor adaptor,
                            boolean strictMatching,
                            ObjectToStringConverter stringConverter,
                            javax.swing.text.Document delegate)
        Creates a new AutoCompleteDocument for the given AbstractAutoCompleteAdaptor.
        Parameters:
        adaptor - The adaptor that will be used to find and select matching items.
        strictMatching - true, if only items from the adaptor's list should be allowed to be entered
        stringConverter - the converter used to transform items to strings
        delegate - the Document delegate backing this document

      • AutoCompleteDocument

        public AutoCompleteDocument​(AbstractAutoCompleteAdaptor adaptor,
                            boolean strictMatching,
                            ObjectToStringConverter stringConverter)
        Creates a new AutoCompleteDocument for the given AbstractAutoCompleteAdaptor.
        Parameters:
        adaptor - The adaptor that will be used to find and select matching items.
        strictMatching - true, if only items from the adaptor's list should be allowed to be entered
        stringConverter - the converter used to transform items to strings

      • AutoCompleteDocument

        public AutoCompleteDocument​(AbstractAutoCompleteAdaptor adaptor,
                            boolean strictMatching)
        Creates a new AutoCompleteDocument for the given AbstractAutoCompleteAdaptor.
        Parameters:
        strictMatching - true, if only items from the adaptor's list should be allowed to be entered
        adaptor - The adaptor that will be used to find and select matching items.

    • Method Detail

      • createDefaultDocument

        protected javax.swing.text.Document createDefaultDocument()
        Creates the default backing document when no delegate is passed to this document.
        Returns:
        the default backing document

      • remove

        public void remove​(int offs,
                   int len)
            throws javax.swing.text.BadLocationException
        Specified by:
        remove in interface javax.swing.text.Document
        Throws:
        javax.swing.text.BadLocationException

      • insertString

        public void insertString​(int offs,
                         java.lang.String str,
                         javax.swing.text.AttributeSet a)
                  throws javax.swing.text.BadLocationException
        Specified by:
        insertString in interface javax.swing.text.Document
        Throws:
        javax.swing.text.BadLocationException

      • addDocumentListener

        public void addDocumentListener​(javax.swing.event.DocumentListener listener)
        Specified by:
        addDocumentListener in interface javax.swing.text.Document

      • addUndoableEditListener

        public void addUndoableEditListener​(javax.swing.event.UndoableEditListener listener)
        Specified by:
        addUndoableEditListener in interface javax.swing.text.Document

      • createPosition

        public javax.swing.text.Position createPosition​(int offs)
                                         throws javax.swing.text.BadLocationException
        Specified by:
        createPosition in interface javax.swing.text.Document
        Throws:
        javax.swing.text.BadLocationException

      • getDefaultRootElement

        public javax.swing.text.Element getDefaultRootElement()
        Specified by:
        getDefaultRootElement in interface javax.swing.text.Document

      • getEndPosition

        public javax.swing.text.Position getEndPosition()
        Specified by:
        getEndPosition in interface javax.swing.text.Document

      • getLength

        public int getLength()
        Specified by:
        getLength in interface javax.swing.text.Document

      • getProperty

        public java.lang.Object getProperty​(java.lang.Object key)
        Specified by:
        getProperty in interface javax.swing.text.Document

      • getRootElements

        public javax.swing.text.Element[] getRootElements()
        Specified by:
        getRootElements in interface javax.swing.text.Document

      • getStartPosition

        public javax.swing.text.Position getStartPosition()
        Specified by:
        getStartPosition in interface javax.swing.text.Document

      • getText

        public java.lang.String getText​(int offset,
                                int length)
                         throws javax.swing.text.BadLocationException
        Specified by:
        getText in interface javax.swing.text.Document
        Throws:
        javax.swing.text.BadLocationException

      • getText

        public void getText​(int offset,
                    int length,
                    javax.swing.text.Segment txt)
             throws javax.swing.text.BadLocationException
        Specified by:
        getText in interface javax.swing.text.Document
        Throws:
        javax.swing.text.BadLocationException

      • putProperty

        public void putProperty​(java.lang.Object key,
                        java.lang.Object value)
        Specified by:
        putProperty in interface javax.swing.text.Document

      • removeDocumentListener

        public void removeDocumentListener​(javax.swing.event.DocumentListener listener)
        Specified by:
        removeDocumentListener in interface javax.swing.text.Document

      • removeUndoableEditListener

        public void removeUndoableEditListener​(javax.swing.event.UndoableEditListener listener)
        Specified by:
        removeUndoableEditListener in interface javax.swing.text.Document

      • render

        public void render​(java.lang.Runnable r)
        Specified by:
        render in interface javax.swing.text.Document

      • isStrictMatching

        public boolean isStrictMatching()
        Returns if only items from the adaptor's list should be allowed to be entered.
        Returns:
        if only items from the adaptor's list should be allowed to be entered