Class PopOver

  • All Implemented Interfaces:
    Styleable, EventTarget, Skinnable

    public class PopOver
    extends PopupControl
    The PopOver control provides detailed information about an owning node in a popup window. The popup window has a very lightweight appearance (no default window decorations) and an arrow pointing at the owner. Due to the nature of popup windows the PopOver will move around with the parent window when the user drags it.
    Screenshot of PopOver

    The PopOver can be detached from the owning node by dragging it away from the owner. It stops displaying an arrow and starts displaying a title and a close icon.

    Screenshot of a detached PopOver

    The following image shows a popover with an accordion content node. PopOver controls are automatically resizing themselves when the content node changes its size.

    Screenshot of PopOver containing an Accordion

    For styling apply stylesheets to the root pane of the PopOver.

    Example:

     PopOver popOver = new PopOver();
     popOver.getRoot().getStylesheets().add(...);
     
    • Constructor Detail

      • PopOver

        public PopOver()
        Creates a pop over with a label as the content node.
      • PopOver

        public PopOver​(Node content)
        Creates a pop over with the given node as the content node.
        Parameters:
        content - The content shown by the pop over
    • Method Detail

      • getRoot

        public final StackPane getRoot()
        The root pane stores the content node of the popover. It is accessible via this method in order to support proper styling.

        Example:

         PopOver popOver = new PopOver();
         popOver.getRoot().getStylesheets().add(...);
         
        Returns:
        the root pane
      • getContentNode

        public final Node getContentNode()
        Returns the value of the content property
        Returns:
        the content node
        See Also:
        contentNodeProperty()
      • setContentNode

        public final void setContentNode​(Node content)
        Sets the value of the content property.
        Parameters:
        content - the new content node value
        See Also:
        contentNodeProperty()
      • show

        public final void show​(Node owner)
        Shows the pop over in a position relative to the edges of the given owner node. The position is dependent on the arrow location. If the arrow is pointing to the right then the pop over will be placed to the left of the given owner. If the arrow points up then the pop over will be placed below the given owner node. The arrow will slightly overlap with the owner node.
        Parameters:
        owner - the owner of the pop over
      • show

        public final void show​(Node owner,
                               double offset)
        Shows the pop over in a position relative to the edges of the given owner node. The position is dependent on the arrow location. If the arrow is pointing to the right then the pop over will be placed to the left of the given owner. If the arrow points up then the pop over will be placed below the given owner node.
        Parameters:
        owner - the owner of the pop over
        offset - if negative specifies the distance to the owner node or when positive specifies the number of pixels that the arrow will overlap with the owner node (positive values are recommended)
      • show

        public final void show​(Window ownerWindow,
                               double anchorX,
                               double anchorY)
        Overrides:
        show in class PopupWindow
      • show

        public final void show​(Node owner,
                               double x,
                               double y)
        Makes the pop over visible at the give location and associates it with the given owner node. The x and y coordinate will be the target location of the arrow of the pop over and not the location of the window.
        Overrides:
        show in class PopupWindow
        Parameters:
        owner - the owning node
        x - the x coordinate for the pop over arrow tip
        y - the y coordinate for the pop over arrow tip
      • show

        public final void show​(Node owner,
                               double x,
                               double y,
                               Duration fadeInDuration)
        Makes the pop over visible at the give location and associates it with the given owner node. The x and y coordinate will be the target location of the arrow of the pop over and not the location of the window.
        Parameters:
        owner - the owning node
        x - the x coordinate for the pop over arrow tip
        y - the y coordinate for the pop over arrow tip
        fadeInDuration - the time it takes for the pop over to be fully visible. This duration takes precedence over the fade-in property without setting.
      • hide

        public final void hide()
        Hides the pop over by quickly changing its opacity to 0.
        Overrides:
        hide in class PopupWindow
        See Also:
        hide(Duration)
      • hide

        public final void hide​(Duration fadeOutDuration)
        Hides the pop over by quickly changing its opacity to 0.
        Parameters:
        fadeOutDuration - the duration of the fade transition that is being used to change the opacity of the pop over
        Since:
        1.0
      • detach

        public final void detach()
        Detaches the pop over from the owning node. The pop over will no longer display an arrow pointing at the owner node.
      • setHeaderAlwaysVisible

        public final void setHeaderAlwaysVisible​(boolean visible)
        Sets the value of the headerAlwaysVisible property.
        Parameters:
        visible - if true, then the header is visible even while attached
        See Also:
        headerAlwaysVisibleProperty()
      • isHeaderAlwaysVisible

        public final boolean isHeaderAlwaysVisible()
        Returns the value of the detachable property.
        Returns:
        true if the header is visible even while attached
        See Also:
        headerAlwaysVisibleProperty()
      • setCloseButtonEnabled

        public final void setCloseButtonEnabled​(boolean enabled)
        Sets the value of the closeButtonEnabled property.
        Parameters:
        enabled - if false, the pop over will not be closeable by the header's close button
        See Also:
        closeButtonEnabledProperty()
      • isCloseButtonEnabled

        public final boolean isCloseButtonEnabled()
        Returns the value of the closeButtonEnabled property.
        Returns:
        true if the header's close button is enabled
        See Also:
        closeButtonEnabledProperty()
      • setDetachable

        public final void setDetachable​(boolean detachable)
        Sets the value of the detachable property.
        Parameters:
        detachable - if true then the user can detach / tear off the pop over
        See Also:
        detachableProperty()
      • isDetachable

        public final boolean isDetachable()
        Returns the value of the detachable property.
        Returns:
        true if the user is allowed to detach / tear off the pop over
        See Also:
        detachableProperty()
      • detachedProperty

        public final BooleanProperty detachedProperty()
        Determines whether the pop over is detached from the owning node or not. A detached pop over no longer shows an arrow pointing at the owner and features its own title bar.
        See Also:
        isDetached(), setDetached(boolean)
      • setDetached

        public final void setDetached​(boolean detached)
        Sets the value of the detached property.
        Parameters:
        detached - if true the pop over will change its apperance to "detached" mode
        See Also:
        detachedProperty()
      • isDetached

        public final boolean isDetached()
        Returns the value of the detached property.
        Returns:
        true if the pop over is currently detached.
        See Also:
        detachedProperty()
      • getArrowSize

        public final double getArrowSize()
        Returns the value of the arrow size property.
        Returns:
        the arrow size property value
        See Also:
        arrowSizeProperty()
      • setArrowSize

        public final void setArrowSize​(double size)
        Sets the value of the arrow size property.
        Parameters:
        size - the new value of the arrow size property
        See Also:
        arrowSizeProperty()
      • getArrowIndent

        public final double getArrowIndent()
        Returns the value of the arrow indent property.
        Returns:
        the arrow indent value
        See Also:
        arrowIndentProperty()
      • setArrowIndent

        public final void setArrowIndent​(double size)
        Sets the value of the arrow indent property.
        Parameters:
        size - the arrow indent value
        See Also:
        arrowIndentProperty()
      • getCornerRadius

        public final double getCornerRadius()
        Returns the value of the corner radius property.
        Returns:
        the corner radius
        See Also:
        cornerRadiusProperty()
      • setCornerRadius

        public final void setCornerRadius​(double radius)
        Sets the value of the corner radius property.
        Parameters:
        radius - the corner radius
        See Also:
        cornerRadiusProperty()
      • getTitle

        public final String getTitle()
        Returns the value of the title property.
        Returns:
        the detached title
        See Also:
        titleProperty()
      • setTitle

        public final void setTitle​(String title)
        Sets the value of the title property.
        Parameters:
        title - the title to use when detached
        See Also:
        titleProperty()
      • getFadeInDuration

        public final Duration getFadeInDuration()
        Returns the value of the fade-in duration property.
        Returns:
        the fade-in duration
        See Also:
        fadeInDurationProperty()
      • setFadeInDuration

        public final void setFadeInDuration​(Duration duration)
        Sets the value of the fade-in duration property. This should be set before calling PopOver.show(..).
        Parameters:
        duration - the requested fade-in duration
        See Also:
        fadeInDurationProperty()
      • getFadeOutDuration

        public final Duration getFadeOutDuration()
        Returns the value of the fade-out duration property.
        Returns:
        the fade-out duration
        See Also:
        fadeOutDurationProperty()
      • setFadeOutDuration

        public final void setFadeOutDuration​(Duration duration)
        Sets the value of the fade-out duration property.
        Parameters:
        duration - the requested fade-out duration
        See Also:
        fadeOutDurationProperty()
      • isAnimated

        public final boolean isAnimated()
        Returns the value of the "animated" property.
        Returns:
        true if the PopOver will be shown and hidden with a short fade animation
        See Also:
        animatedProperty()
      • setAnimated

        public final void setAnimated​(boolean animated)
        Sets the value of the "animated" property.
        Parameters:
        animated - if true the PopOver will be shown and hidden with a short fade animation
        See Also:
        animatedProperty()