Class AutoCompletionBinding<T>

  • Type Parameters:
    T - Model-Type of the suggestions
    All Implemented Interfaces:
    javafx.event.EventTarget

    public abstract class AutoCompletionBinding<T>
    extends Object
    implements javafx.event.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​(javafx.scene.Node completionTarget,
                                        javafx.util.Callback<AutoCompletionBinding.ISuggestionRequest,​Collection<T>> suggestionProvider,
                                        javafx.util.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 javafx.scene.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.
      • visibleRowCountProperty

        public final javafx.beans.property.IntegerProperty visibleRowCountProperty()
        Return an property representing the maximum number of rows to be visible in the popup when it is showing.
        Returns:
        an property representing 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.
      • prefWidthProperty

        public final javafx.beans.property.DoubleProperty prefWidthProperty()
        Return the property associated with the pref width.
        Returns:
      • 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.
      • minWidthProperty

        public final javafx.beans.property.DoubleProperty minWidthProperty()
        Return the property associated with the min width.
        Returns:
      • 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.
      • maxWidthProperty

        public final javafx.beans.property.DoubleProperty maxWidthProperty()
        Return the property associated with the max width.
        Returns:
      • 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)
      • setOnAutoCompleted

        public final void setOnAutoCompleted​(javafx.event.EventHandler<AutoCompletionBinding.AutoCompletionEvent<T>> value)
        Set a event handler which is invoked after an auto completion.
        Parameters:
        value -
      • addEventHandler

        public <E extends javafx.event.Event> void addEventHandler​(javafx.event.EventType<E> eventType,
                                                                   javafx.event.EventHandler<? super 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 javafx.event.Event> void removeEventHandler​(javafx.event.EventType<E> eventType,
                                                                      javafx.event.EventHandler<? super 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
      • buildEventDispatchChain

        public javafx.event.EventDispatchChain buildEventDispatchChain​(javafx.event.EventDispatchChain tail)
        Specified by:
        buildEventDispatchChain in interface javafx.event.EventTarget