com.haulmont.cuba.gui.components

Interface PopupButton

All Superinterfaces:

ActionsHolder, Component, Component.BelongToFrame, Component.Focusable, Component.HasCaption, Component.HasDescription, Component.HasIcon, HasHtmlCaption, HasHtmlDescription, HasSubParts

public interface PopupButton
extends ActionsHolder, Component.HasCaption, Component.BelongToFrame, Component.HasIcon, Component.Focusable, HasHtmlCaption, HasHtmlDescription

A Button with a popup. The popup can contain actions.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	PopupButton.PopupOpenDirection Opening direction for the popup.
static class	PopupButton.PopupVisibilityEvent Event sent when the visibility of the popup changes.

Nested classes/interfaces inherited from interface com.haulmont.cuba.gui.components.Component

Component.Alignment, Component.BelongToFrame, Component.Disposable, Component.Editable, Component.Focusable, Component.HasCaption, Component.HasDescription, Component.HasIcon, Component.HasXmlDescriptor, Component.OptionsStyleProvider, Component.Wrapper

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NAME

Fields inherited from interface com.haulmont.cuba.gui.components.Component

AUTO_SIZE, AUTO_SIZE_PX, FULL_SIZE, UNITS_PERCENTAGE, UNITS_PIXELS

Method Summary

Modifier and Type	Method and Description
com.haulmont.bali.events.Subscription	addPopupVisibilityListener(java.util.function.Consumer<PopupButton.PopupVisibilityEvent> listener)
float	getMenuWidth()
SizeUnit	getMenuWidthSizeUnit() Gets the menu width property units.
int	getMenuWidthUnits() Deprecated. Use getMenuWidthSizeUnit()
Component	getPopupContent()
PopupButton.PopupOpenDirection	getPopupOpenDirection()
boolean	isAutoClose()
boolean	isClosePopupOnOutsideClick()
boolean	isPopupVisible()
boolean	isShowActionIcons() Return show icons for action buttons
boolean	isTogglePopupVisibilityOnClick()
void	removePopupVisibilityListener(java.util.function.Consumer<PopupButton.PopupVisibilityEvent> listener) Deprecated. Use Subscription instead
void	setAutoClose(boolean autoClose) Set menu automatic close after option click.
void	setClosePopupOnOutsideClick(boolean closePopupOnOutsideClick) If set to true, clicking on outside the popup closes it.
void	setMenuWidth(java.lang.String width) Set menu width.
void	setPopupContent(Component popupContent) Set custom inner content for the popup.
void	setPopupOpenDirection(PopupButton.PopupOpenDirection direction) Sets opening direction for the popup.
void	setPopupVisible(boolean popupVisible) Open or close popup panel.
void	setShowActionIcons(boolean showActionIcons) Set show icons for action buttons
void	setTogglePopupVisibilityOnClick(boolean togglePopupVisibilityOnClick) Sets sequential click on popup will toggle popup visibility.

Methods inherited from interface com.haulmont.cuba.gui.components.ActionsHolder

addAction, addAction, getAction, getActionNN, getActions, getSubPart, removeAction, removeAction, removeAllActions

Methods inherited from interface com.haulmont.cuba.gui.components.Component.BelongToFrame

getFrame, setFrame

Methods inherited from interface com.haulmont.cuba.gui.components.Component.HasIcon

getIcon, setIcon, setIconFromSet

Methods inherited from interface com.haulmont.cuba.gui.components.Component.Focusable

focus, getTabIndex, isFocusable, setFocusable, setTabIndex

Methods inherited from interface com.haulmont.cuba.gui.components.Component

addStyleName, getAlignment, getHeight, getHeightSizeUnit, getHeightUnits, getId, getParent, getStyleName, getWidth, getWidthSizeUnit, getWidthUnits, isEnabled, isEnabledItself, isEnabledRecursive, isResponsive, isVisible, isVisibleItself, isVisibleRecursive, removeStyleName, requestFocus, setAlignment, setEnabled, setHeight, setHeightAuto, setHeightFull, setId, setParent, setResponsive, setSizeAuto, setSizeFull, setStyleName, setVisible, setWidth, setWidthAuto, setWidthFull, unwrap, unwrapComposition

Methods inherited from interface com.haulmont.cuba.gui.components.HasHtmlCaption

isCaptionAsHtml, setCaptionAsHtml

Methods inherited from interface com.haulmont.cuba.gui.components.Component.HasCaption

getCaption, setCaption

Methods inherited from interface com.haulmont.cuba.gui.components.Component.HasDescription

getDescription, setDescription

Methods inherited from interface com.haulmont.cuba.gui.components.HasHtmlDescription

isDescriptionAsHtml, setDescriptionAsHtml

Field Detail

NAME

static final java.lang.String NAME

See Also:

Constant Field Values

Method Detail

isPopupVisible

boolean isPopupVisible()

Returns:

true if popup is opened

setPopupVisible

void setPopupVisible(boolean popupVisible)

Open or close popup panel.

Parameters:

popupVisible - whether open or close popup panel.

setMenuWidth

void setMenuWidth(java.lang.String width)

Set menu width.

Parameters:

width - new menu width

getMenuWidth

float getMenuWidth()

Returns:

menu width

getMenuWidthUnits

@Deprecated
int getMenuWidthUnits()

Deprecated. Use getMenuWidthSizeUnit()

Returns:

one of width units: Component.UNITS_PIXELS, Component.UNITS_PERCENTAGE

getMenuWidthSizeUnit

SizeUnit getMenuWidthSizeUnit()

Gets the menu width property units.

Returns:

units used in the menu width property.

isAutoClose

boolean isAutoClose()

Returns:

whether to close menu automatically after action triggering or not

setAutoClose

void setAutoClose(boolean autoClose)

Set menu automatic close after option click.

Parameters:

autoClose - whether to close menu automatically after action triggering or not

setShowActionIcons

void setShowActionIcons(boolean showActionIcons)

Set show icons for action buttons

isShowActionIcons

boolean isShowActionIcons()

Return show icons for action buttons

isTogglePopupVisibilityOnClick

boolean isTogglePopupVisibilityOnClick()

Returns:

if sequential click on popup will toggle popup visibility

setTogglePopupVisibilityOnClick

void setTogglePopupVisibilityOnClick(boolean togglePopupVisibilityOnClick)

Sets sequential click on popup will toggle popup visibility.

Parameters:

togglePopupVisibilityOnClick - true if sequential click on popup should toggle popup visibility

getPopupOpenDirection

PopupButton.PopupOpenDirection getPopupOpenDirection()

Returns:

opening direction for the popup

setPopupOpenDirection

void setPopupOpenDirection(PopupButton.PopupOpenDirection direction)

Sets opening direction for the popup.

Parameters:

direction - new direction

isClosePopupOnOutsideClick

boolean isClosePopupOnOutsideClick()

Returns:

true if a click outside the popup closing the popup, otherwise - false

setClosePopupOnOutsideClick

void setClosePopupOnOutsideClick(boolean closePopupOnOutsideClick)

If set to true, clicking on outside the popup closes it. Note that this doesn't affect clicking on the button itself.

Parameters:

closePopupOnOutsideClick - whether to close popup on outside click

setPopupContent

void setPopupContent(@Nullable
                     Component popupContent)

Set custom inner content for the popup. Actions are ignored if a custom popup content is set.

Parameters:

popupContent - popup component.

getPopupContent

@Nullable
Component getPopupContent()

Returns:

popup content component

addPopupVisibilityListener

com.haulmont.bali.events.Subscription addPopupVisibilityListener(java.util.function.Consumer<PopupButton.PopupVisibilityEvent> listener)

removePopupVisibilityListener

@Deprecated
void removePopupVisibilityListener(java.util.function.Consumer<PopupButton.PopupVisibilityEvent> listener)

Deprecated. Use Subscription instead

Parameters:

listener - a listener to remove