com.vaadin.addon.spreadsheet

Class PopupButton

java.lang.Object

com.vaadin.server.AbstractClientConnector

com.vaadin.ui.AbstractComponent

com.vaadin.addon.spreadsheet.PopupButton

All Implemented Interfaces:

com.vaadin.event.ContextClickEvent.ContextClickNotifier, com.vaadin.event.MethodEventSource, com.vaadin.server.ClientConnector, com.vaadin.server.Sizeable, com.vaadin.shared.Connector, com.vaadin.ui.Component, com.vaadin.ui.HasComponents, Serializable, Iterable<com.vaadin.ui.Component>

public class PopupButton
extends com.vaadin.ui.AbstractComponent
implements com.vaadin.ui.HasComponents

A button component that when clicked opens a pop-up next to spreadsheet cell containing the button.

Vaadin components can be added inside the pop-up.

By default, the pop-up displays a close-button and a header containing the current value of the cell that the pop-up button belongs to.

A button can be marked with "active" style with markActive(boolean).

To add the pop-up button to a specific spreadsheet, call Spreadsheet.setPopup(CellReference, PopupButton), Spreadsheet.setPopup(String, PopupButton) or Spreadsheet.setPopup(int, int, PopupButton). The button can be removed from the target cell by giving null as the PopupButton parameter to one of the previously mentioned methods.

Author:

Vaadin Ltd.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PopupButton.PopupCloseEvent An event fired after the pop-up for the PopupButton returned by PopupButton.PopupCloseEvent.getPopupButton() has been closed.
static interface	PopupButton.PopupCloseListener Interface for listening for a PopupButton.PopupCloseEvent fired by a PopupButton.
static class	PopupButton.PopupOpenEvent An event fired after the pop-up button returned by PopupButton.PopupOpenEvent.getPopupButton() has been clicked and the pop-up has been opened.
static interface	PopupButton.PopupOpenListener Interface for listening for a PopupButton.PopupOpenEvent fired by a PopupButton.

Nested classes/interfaces inherited from interface com.vaadin.ui.HasComponents

com.vaadin.ui.HasComponents.ComponentAttachDetachNotifier, com.vaadin.ui.HasComponents.ComponentAttachEvent, com.vaadin.ui.HasComponents.ComponentAttachListener, com.vaadin.ui.HasComponents.ComponentDetachEvent, com.vaadin.ui.HasComponents.ComponentDetachListener

Nested classes/interfaces inherited from interface com.vaadin.ui.Component

com.vaadin.ui.Component.ErrorEvent, com.vaadin.ui.Component.Event, com.vaadin.ui.Component.Focusable, com.vaadin.ui.Component.Listener

Nested classes/interfaces inherited from interface com.vaadin.server.ClientConnector

com.vaadin.server.ClientConnector.AttachEvent, com.vaadin.server.ClientConnector.AttachListener, com.vaadin.server.ClientConnector.ConnectorErrorEvent, com.vaadin.server.ClientConnector.DetachEvent, com.vaadin.server.ClientConnector.DetachListener

Nested classes/interfaces inherited from interface com.vaadin.server.Sizeable

com.vaadin.server.Sizeable.Unit

Field Summary

Fields inherited from class com.vaadin.ui.AbstractComponent

DESIGN_ATTR_PLAIN_TEXT

Fields inherited from interface com.vaadin.server.Sizeable

SIZE_UNDEFINED, UNITS_CM, UNITS_EM, UNITS_EX, UNITS_INCH, UNITS_MM, UNITS_PERCENTAGE, UNITS_PICAS, UNITS_PIXELS, UNITS_POINTS

Constructor Summary

Constructors

Constructor and Description
PopupButton() Constructs a new PopupButton.
PopupButton(com.vaadin.ui.Component content) Constructs a new PopupButton with the given content.

Method Summary

Modifier and Type	Method and Description
void	addPopupCloseListener(PopupButton.PopupCloseListener listener) Adds a PopupButton.PopupCloseListener to this pop-up button.
void	addPopupOpenListener(PopupButton.PopupOpenListener listener) Adds a PopupButton.PopupOpenListener to this pop-up button.
void	closePopup() Closes the pop-up if it is open.
void	detach()
org.apache.poi.ss.util.CellReference	getCellReference() Gets the cell reference for the cell that contains this pop-up button.
int	getColumn() Gets the column for this pop-up button.
com.vaadin.ui.Component	getContent() Get the contents of the popup.
String	getPopupHeight() Gets the height for this pop-up button's pop-up.
String	getPopupWidth() Gets the width for this pop-up button's pop-up.
int	getRow() Gets the row for this pop-up button.
protected PopupButtonState	getState()
protected PopupButtonState	getState(boolean markAsDirty)
boolean	isActive()
boolean	isHeaderHidden() Tells if the pop-up header is currently hidden.
Iterator<com.vaadin.ui.Component>	iterator()
void	markActive(boolean active) Mark the button with "active" - style.
void	openPopup() Opens the pop-up if the button is currently rendered in the visible area of the Spreadsheet.
void	removePopupCloseListener(PopupButton.PopupCloseListener listener) Removes the given PopupButton.PopupCloseListener from this pop-up button.
void	removePopupOpenListener(PopupButton.PopupOpenListener listener) Removes the given PopupButton.PopupOpenListener from this pop-up button.
void	setContent(com.vaadin.ui.Component content) Set the contents of the popup.
void	setHeaderHidden(boolean headerHidden) Sets the pop-up header visible or hidden.
void	setPopupHeight(String height) Set the height for this pop-up button's pop-up.
void	setPopupWidth(String width) Set the width for this pop-up button's pop-up.

Methods inherited from class com.vaadin.ui.AbstractComponent

addContextClickListener, addListener, addShortcutListener, addStyleName, attach, beforeClientResponse, findAncestor, fireComponentErrorEvent, fireComponentEvent, focus, getActionManager, getCaption, getComponentError, getCustomAttributes, getData, getDebugId, getDescription, getErrorMessage, getHeight, getHeightUnits, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getStyleName, getWidth, getWidthUnits, isCaptionAsHtml, isConnectorEnabled, isEnabled, isOrHasAncestor, isReadOnly, isRequiredIndicatorVisible, isResponsive, isVisible, readDesign, removeContextClickListener, removeListener, removeShortcutListener, removeStyleName, setCaption, setCaptionAsHtml, setComponentError, setData, setDebugId, setDescription, setDescription, setEnabled, setHeight, setHeight, setHeightFull, setHeightUndefined, setIcon, setId, setLocale, setParent, setPrimaryStyleName, setReadOnly, setRequiredIndicatorVisible, setResponsive, setSizeFull, setSizeUndefined, setStyleName, setVisible, setWidth, setWidth, setWidthFull, setWidthUndefined, writeDesign

Methods inherited from class com.vaadin.server.AbstractClientConnector

addAttachListener, addDetachListener, addExtension, addListener, addListener, addListener, addListener, addListener, addListener, addMethodInvocationToQueue, createState, encodeState, equals, fireEvent, getAllChildrenIterable, getConnectorId, getErrorHandler, getExtensions, getListeners, getResource, getRpcManager, getRpcProxy, getSession, getStateType, getUI, handleConnectorRequest, hashCode, hasListeners, isAttached, isThis, markAsDirty, markAsDirtyRecursive, registerRpc, registerRpc, removeAttachListener, removeDetachListener, removeExtension, removeListener, removeListener, removeListener, removeListener, removeListener, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler, setResource, updateDiffstate

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.vaadin.ui.Component

addListener, addStyleName, addStyleNames, attach, getCaption, getDescription, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getStyleName, getUI, isEnabled, isVisible, readDesign, removeListener, removeStyleName, removeStyleNames, setCaption, setEnabled, setIcon, setId, setParent, setPrimaryStyleName, setStyleName, setStyleName, setVisible, writeDesign

Methods inherited from interface com.vaadin.server.ClientConnector

addAttachListener, addDetachListener, beforeClientResponse, encodeState, getErrorHandler, getExtensions, getRpcManager, getStateType, handleConnectorRequest, isAttached, isConnectorEnabled, markAsDirty, markAsDirtyRecursive, removeAttachListener, removeDetachListener, removeExtension, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler

Methods inherited from interface com.vaadin.shared.Connector

getConnectorId

Methods inherited from interface com.vaadin.server.Sizeable

getHeight, getHeightUnits, getWidth, getWidthUnits, setHeight, setHeight, setHeightFull, setHeightUndefined, setSizeFull, setSizeUndefined, setWidth, setWidth, setWidthFull, setWidthUndefined

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

PopupButton

public PopupButton()

Constructs a new PopupButton.

PopupButton

public PopupButton(com.vaadin.ui.Component content)

Constructs a new PopupButton with the given content.

Parameters:

content - Content of the pop-up

Method Detail

getCellReference

public org.apache.poi.ss.util.CellReference getCellReference()

Gets the cell reference for the cell that contains this pop-up button.

Returns:

Target cell reference

getColumn

public int getColumn()

Gets the column for this pop-up button.

Returns:

Column index, 0-based

getRow

public int getRow()

Gets the row for this pop-up button.

Returns:

Row index, 0-based

openPopup

public void openPopup()

Opens the pop-up if the button is currently rendered in the visible area of the Spreadsheet.

closePopup

public void closePopup()

Closes the pop-up if it is open.

isHeaderHidden

public boolean isHeaderHidden()

Tells if the pop-up header is currently hidden.

Returns:

true if header is hidden, false otherwise

setHeaderHidden

public void setHeaderHidden(boolean headerHidden)

Sets the pop-up header visible or hidden.

Parameters:

headerHidden - true for hidden, false for visible.

setPopupWidth

public void setPopupWidth(String width)

Set the width for this pop-up button's pop-up. Can be null or empty for undefined width.

Parameters:

width - New width for the pop-up

getPopupWidth

public String getPopupWidth()

Gets the width for this pop-up button's pop-up. Can be null or empty.

Returns:

Width of the pop-up

setPopupHeight

public void setPopupHeight(String height)

Set the height for this pop-up button's pop-up. Can be null or empty for undefined height.

Parameters:

height - New height for the pop-up

getPopupHeight

public String getPopupHeight()

Gets the height for this pop-up button's pop-up. Can be null or empty.

Returns:

Height of the pop-up

getState

protected PopupButtonState getState()

Overrides:

getState in class com.vaadin.ui.AbstractComponent

getState

protected PopupButtonState getState(boolean markAsDirty)

Overrides:

getState in class com.vaadin.ui.AbstractComponent

setContent

public void setContent(com.vaadin.ui.Component content)

Set the contents of the popup.

getContent

public com.vaadin.ui.Component getContent()

Get the contents of the popup.

iterator

public Iterator<com.vaadin.ui.Component> iterator()

Specified by:

iterator in interface com.vaadin.ui.HasComponents

Specified by:

iterator in interface Iterable<com.vaadin.ui.Component>

markActive

public void markActive(boolean active)

Mark the button with "active" - style. See PopupButtonWidget for the CSS class name.

Parameters:

active - true to add "active" style, false to remove it

isActive

public boolean isActive()

addPopupOpenListener

public void addPopupOpenListener(PopupButton.PopupOpenListener listener)

Adds a PopupButton.PopupOpenListener to this pop-up button.

Parameters:

listener - The listener to add

removePopupOpenListener

public void removePopupOpenListener(PopupButton.PopupOpenListener listener)

Removes the given PopupButton.PopupOpenListener from this pop-up button.

Parameters:

listener - The listener to remove

addPopupCloseListener

public void addPopupCloseListener(PopupButton.PopupCloseListener listener)

Adds a PopupButton.PopupCloseListener to this pop-up button.

Parameters:

listener -

removePopupCloseListener

public void removePopupCloseListener(PopupButton.PopupCloseListener listener)

Removes the given PopupButton.PopupCloseListener from this pop-up button.

Parameters:

listener -

detach

public void detach()

Specified by:

detach in interface com.vaadin.server.ClientConnector

Overrides:

detach in class com.vaadin.ui.AbstractComponent