Class AutoCompletionBinding<T>

  • Type Parameters:
    T - Model-Type of the suggestions
    All Implemented Interfaces:
    EventTarget
    Direct Known Subclasses:
    AutoCompletionTextFieldBinding

    public abstract class AutoCompletionBinding<T>
    extends Object
    implements EventTarget
    The AutoCompletionBinding is the abstract base class of all auto-completion bindings. This class is the core logic for the auto-completion feature but highly customizable.

    To use the autocompletion functionality, refer to the TextFields class. The popup size can be modified through its setVisibleRowCount(int) for the height and all the usual methods for the width.

    See Also:
    TextFields
    • Constructor Detail

      • AutoCompletionBinding

        protected AutoCompletionBinding​(Node completionTarget,
                                        Callback<AutoCompletionBinding.ISuggestionRequest,​Collection<T>> suggestionProvider,
                                        StringConverter<T> converter)
        Creates a new AutoCompletionBinding
        Parameters:
        completionTarget - The target node to which auto-completion shall be added
        suggestionProvider - The strategy to retrieve suggestions
        converter - The converter to be used to convert suggestions to strings
    • Method Detail

      • setHideOnEscape

        public void setHideOnEscape​(boolean value)
        Specifies whether the PopupWindow should be hidden when an unhandled escape key is pressed while the popup has focus.
        Parameters:
        value -
      • setUserInput

        public final void setUserInput​(String userText)
        Set the current text the user has entered
        Parameters:
        userText -
      • setDelay

        public final void setDelay​(long delay)
        Sets the delay in ms between a key press and the suggestion popup being displayed.
        Parameters:
        delay -
      • getCompletionTarget

        public Node getCompletionTarget()
        Gets the target node for auto completion
        Returns:
        the target node for auto completion
      • dispose

        public abstract void dispose()
        Disposes the binding.
      • setVisibleRowCount

        public final void setVisibleRowCount​(int value)
        Set the maximum number of rows to be visible in the popup when it is showing.
        Parameters:
        value -
      • getVisibleRowCount

        public final int getVisibleRowCount()
        Return the maximum number of rows to be visible in the popup when it is showing.
        Returns:
        the maximum number of rows to be visible in the popup when it is showing.
      • setPrefWidth

        public final void setPrefWidth​(double value)
        Sets the prefWidth of the popup.
        Parameters:
        value -
      • getPrefWidth

        public final double getPrefWidth()
        Return the pref width of the popup.
        Returns:
        the pref width of the popup.
      • setMinWidth

        public final void setMinWidth​(double value)
        Sets the minWidth of the popup.
        Parameters:
        value -
      • getMinWidth

        public final double getMinWidth()
        Return the min width of the popup.
        Returns:
        the min width of the popup.
      • setMaxWidth

        public final void setMaxWidth​(double value)
        Sets the maxWidth of the popup.
        Parameters:
        value -
      • getMaxWidth

        public final double getMaxWidth()
        Return the max width of the popup.
        Returns:
        the max width of the popup.
      • getAutoCompletionPopup

        public AutoCompletePopup<T> getAutoCompletionPopup()
        Get the AutoCompletePopup used by this binding. Note that this gives access to the internal API and should be used with great care (and in the expectation that things may break in the future). All relevant methods of the popup are already exposed in this class.

        The only reason this is exposed is to allow custom skins for the popup.

        Returns:
        the AutoCompletePopup used by this binding
      • completeUserInput

        protected abstract void completeUserInput​(T completion)
        Complete the current user-input with the provided completion. Sub-classes have to provide a concrete implementation.
        Parameters:
        completion -
      • showPopup

        protected void showPopup()
        Show the auto completion popup
      • hidePopup

        protected void hidePopup()
        Hide the auto completion targets
      • fireAutoCompletion

        protected void fireAutoCompletion​(T completion)
      • addEventHandler

        public <E extends Event> void addEventHandler​(EventType<E> eventType,
                                                      EventHandler<E> eventHandler)
        Registers an event handler to this EventTarget. The handler is called when the menu item receives an Event of the specified type during the bubbling phase of event delivery.
        Type Parameters:
        E - the specific event class of the handler
        Parameters:
        eventType - the type of the events to receive by the handler
        eventHandler - the handler to register
        Throws:
        NullPointerException - if the event type or handler is null
      • removeEventHandler

        public <E extends Event> void removeEventHandler​(EventType<E> eventType,
                                                         EventHandler<E> eventHandler)
        Unregisters a previously registered event handler from this EventTarget. One handler might have been registered for different event types, so the caller needs to specify the particular event type from which to unregister the handler.
        Type Parameters:
        E - the specific event class of the handler
        Parameters:
        eventType - the event type from which to unregister
        eventHandler - the handler to unregister
        Throws:
        NullPointerException - if the event type or handler is null