com.haulmont.cuba.gui.components

Interface PopupButton

All Superinterfaces:

Component, Component.ActionsHolder, Component.BelongToFrame, Component.Focusable, Component.HasCaption, Component.HasIcon

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

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 This event is received by the PopupVisibilityListeners when the visibility of the popup changes.
static interface	PopupButton.PopupVisibilityListener Popup window visibility change listener.

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

Component.ActionOwner, Component.ActionsHolder, Component.Alignment, Component.BelongToFrame, Component.Buffered, Component.ChildEditableController, Component.Collapsable, Component.Container, Component.ContextHelpIconClickEvent, Component.Disposable, Component.Editable, Component.EditableChangeEvent, Component.EditableChangeListener, Component.EditableChangeNotifier, Component.ExpandedStateChangeEvent, Component.ExpandedStateChangeListener, Component.Focusable, Component.HasBorder, Component.HasButtonsPanel, Component.HasCaption, Component.HasContextHelp, Component.HasFormatter, Component.HasIcon, Component.HasInputPrompt, Component.HasNamedComponents, Component.HasOptionsStyleProvider, Component.HasPresentations, Component.HasRowsCount, Component.HasSettings, Component.HasValue, Component.HasXmlDescriptor, Component.LayoutClickEvent, Component.LayoutClickListener, Component.LayoutClickNotifier, Component.Margin, Component.MouseEventDetails, Component.OptionsStyleProvider, Component.OrderedContainer, Component.OuterMargin, Component.SecuredActionsHolder, Component.ShortcutAction, Component.ShortcutNotifier, Component.ShortcutTriggeredEvent, Component.Spacing, Component.UiPermissionAware, Component.Validatable, Component.ValueChangeEvent, Component.ValueChangeListener, 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, UNITS_PERCENTAGE, UNITS_PIXELS

Method Summary

Modifier and Type	Method and Description
void	addPopupVisibilityListener(PopupButton.PopupVisibilityListener listener)
float	getMenuWidth()
int	getMenuWidthUnits()
Component	getPopupContent()
PopupButton.PopupOpenDirection	getPopupOpenDirection()
boolean	isAutoClose()
boolean	isClosePopupOnOutsideClick()
boolean	isPopupVisible()
boolean	isShowActionIcons() Return show icons for action buttons
boolean	isTogglePopupVisibilityOnClick()
void	removePopupVisibilityListener(PopupButton.PopupVisibilityListener listener)
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.Component.ActionsHolder

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

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

getCaption, getDescription, setCaption, setDescription

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

getTabIndex, isFocusable, setFocusable, setTabIndex

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

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

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

int getMenuWidthUnits()

Returns:

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

isAutoClose

boolean isAutoClose()

Returns:

whether to close menu automatically after action triggerring or not

setAutoClose

void setAutoClose(boolean autoClose)

Set menu automatic close after option click.

Parameters:

autoClose - whether to close menu automatically after action triggerring 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 ouside 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

void addPopupVisibilityListener(PopupButton.PopupVisibilityListener listener)

removePopupVisibilityListener

void removePopupVisibilityListener(PopupButton.PopupVisibilityListener listener)