com.vaadin.ui
Class AbstractColorPicker

java.lang.Object
  com.vaadin.server.AbstractClientConnector
      com.vaadin.ui.AbstractComponent
          com.vaadin.ui.AbstractColorPicker

All Implemented Interfaces:

MethodEventSource, ClientConnector, Sizeable, com.vaadin.shared.Connector, Component, ColorSelector, HasColorChangeListener, Window.CloseListener, java.io.Serializable

Direct Known Subclasses:

ColorPicker, ColorPickerArea

public abstract class AbstractColorPicker
extends AbstractComponent
implements Window.CloseListener, ColorSelector

An abstract class that defines default implementation for a color picker component.

Since:

7.0.0

See Also:

Serialized Form

Nested Class Summary

static interface	AbstractColorPicker.Coordinates2Color Interface for converting 2d-coordinates to a Color
static class	AbstractColorPicker.PopupStyle

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

Component.ErrorEvent, Component.Event, Component.Focusable, Component.Listener

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

ClientConnector.AttachEvent, ClientConnector.AttachListener, ClientConnector.ConnectorErrorEvent, ClientConnector.DetachEvent, ClientConnector.DetachListener

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

Sizeable.Unit

Field Summary

protected com.vaadin.shared.ui.colorpicker.Color	color The color.
protected boolean	historyVisible
protected boolean	hsvVisible
protected java.lang.String	popupCaption
protected AbstractColorPicker.PopupStyle	popupStyle
protected boolean	rgbVisible
protected static java.lang.String	STYLENAME_AREA
protected static java.lang.String	STYLENAME_BUTTON
protected static java.lang.String	STYLENAME_DEFAULT
protected boolean	swatchesVisible
protected boolean	textfieldVisible

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

AbstractColorPicker()
Instantiates a new color picker.

AbstractColorPicker(java.lang.String popupCaption)
Instantiates a new color picker.

AbstractColorPicker(java.lang.String popupCaption, com.vaadin.shared.ui.colorpicker.Color initialColor)
Instantiates a new color picker.

Method Summary

void	addColorChangeListener(ColorChangeListener listener) Adds a ColorChangeListener to the component.
protected void	colorChanged(ColorChangeEvent event) Fired when a color change event occurs
void	fireColorChanged() Notifies the listeners that the selected color has changed
com.vaadin.shared.ui.colorpicker.Color	getColor() Gets the color.
protected com.vaadin.shared.ui.colorpicker.ColorPickerState	getState() Returns the shared state bean with information to be sent from the server to the client.
void	hidePopup() Hides a popup-window for color selection.
boolean	isDefaultCaptionEnabled() Returns true if the component shows the default caption (css-code for the currently selected color, e.g.
boolean	isHtmlContentAllowed() Return HTML rendering setting
void	removeColorChangeListener(ColorChangeListener listener) Removes a ColorChangeListener from the component.
void	setColor(com.vaadin.shared.ui.colorpicker.Color color) Sets the color.
void	setDefaultCaptionEnabled(boolean enabled) Set true if the component should show a default caption (css-code for the currently selected color, e.g.
protected abstract void	setDefaultStyles() Sets the default styles of the component
void	setHistoryVisibility(boolean visible) Sets the visibility of the Color History
void	setHSVVisibility(boolean visible) Set the visibility of the HSV Tab
void	setHtmlContentAllowed(boolean htmlContentAllowed) Set whether the caption text is rendered as HTML or not.
void	setPopupStyle(AbstractColorPicker.PopupStyle style) The style for the popup window
void	setPosition(int x, int y) Sets the position of the popup window
void	setRGBVisibility(boolean visible) Set the visibility of the RGB Tab
void	setSwatchesVisibility(boolean visible) Set the visibility of the Swatches Tab
void	setTextfieldVisibility(boolean visible) Sets the visibility of the CSS color code text field
void	showPopup() Shows a popup-window for color selection.
protected void	showPopup(boolean open) Shows or hides popup-window depending on the given parameter.
void	windowClose(Window.CloseEvent e) Called when the user closes a window.

Methods inherited from class com.vaadin.ui.AbstractComponent

addListener, addShortcutListener, addStyleName, attach, beforeClientResponse, detach, findAncestor, fireComponentErrorEvent, fireComponentEvent, focus, getActionManager, getCaption, getComponentError, getData, getDebugId, getDescription, getErrorMessage, getHeight, getHeightUnits, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getState, getStyleName, getWidth, getWidthUnits, isConnectorEnabled, isEnabled, isImmediate, isReadOnly, isVisible, removeListener, removeShortcutListener, removeStyleName, setCaption, setComponentError, setData, setDebugId, setDescription, setEnabled, setHeight, setHeight, setIcon, setId, setImmediate, setLocale, setParent, setPrimaryStyleName, setReadOnly, setSizeFull, setSizeUndefined, setStyleName, setVisible, setWidth, setWidth

Methods inherited from class com.vaadin.server.AbstractClientConnector

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.vaadin.ui.Component

getUI

Methods inherited from interface com.vaadin.server.ClientConnector

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

Methods inherited from interface com.vaadin.shared.Connector

getConnectorId

Field Detail

STYLENAME_DEFAULT

protected static final java.lang.String STYLENAME_DEFAULT

See Also:

Constant Field Values

STYLENAME_BUTTON

protected static final java.lang.String STYLENAME_BUTTON

See Also:

Constant Field Values

STYLENAME_AREA

protected static final java.lang.String STYLENAME_AREA

See Also:

Constant Field Values

popupStyle

protected AbstractColorPicker.PopupStyle popupStyle

color

protected com.vaadin.shared.ui.colorpicker.Color color

The color.

popupCaption

protected java.lang.String popupCaption

rgbVisible

protected boolean rgbVisible

hsvVisible

protected boolean hsvVisible

swatchesVisible

protected boolean swatchesVisible

historyVisible

protected boolean historyVisible

textfieldVisible

protected boolean textfieldVisible

Constructor Detail

AbstractColorPicker

public AbstractColorPicker()

Instantiates a new color picker.

AbstractColorPicker

public AbstractColorPicker(java.lang.String popupCaption)

Instantiates a new color picker.

Parameters:

popupCaption - the caption of the popup window

AbstractColorPicker

public AbstractColorPicker(java.lang.String popupCaption,
                           com.vaadin.shared.ui.colorpicker.Color initialColor)

Instantiates a new color picker.

Parameters:

popupCaption - the caption of the popup window

initialColor - the initial color

Method Detail

setColor

public void setColor(com.vaadin.shared.ui.colorpicker.Color color)

Description copied from interface: ColorSelector

Sets the color.

Specified by:

setColor in interface ColorSelector

Parameters:

color - the new color

getColor

public com.vaadin.shared.ui.colorpicker.Color getColor()

Description copied from interface: ColorSelector

Gets the color.

Specified by:

getColor in interface ColorSelector

Returns:

the color

setDefaultCaptionEnabled

public void setDefaultCaptionEnabled(boolean enabled)

Set true if the component should show a default caption (css-code for the currently selected color, e.g. #ffffff) when no other caption is available.

Parameters:

enabled -

isDefaultCaptionEnabled

public boolean isDefaultCaptionEnabled()

Returns true if the component shows the default caption (css-code for the currently selected color, e.g. #ffffff) if no other caption is available.

setPosition

public void setPosition(int x,
                        int y)

Sets the position of the popup window

Parameters:

x - the x-coordinate

y - the y-coordinate

addColorChangeListener

public void addColorChangeListener(ColorChangeListener listener)

Description copied from interface: HasColorChangeListener

Adds a ColorChangeListener to the component.

Specified by:

addColorChangeListener in interface HasColorChangeListener

removeColorChangeListener

public void removeColorChangeListener(ColorChangeListener listener)

Description copied from interface: HasColorChangeListener

Removes a ColorChangeListener from the component.

Specified by:

removeColorChangeListener in interface HasColorChangeListener

windowClose

public void windowClose(Window.CloseEvent e)

Description copied from interface: Window.CloseListener

Called when the user closes a window. Use Window.CloseEvent.getWindow() to get a reference to the Window that was closed.

Specified by:

windowClose in interface Window.CloseListener

Parameters:

e - Event containing

colorChanged

protected void colorChanged(ColorChangeEvent event)

Fired when a color change event occurs

Parameters:

event - The color change event

fireColorChanged

public void fireColorChanged()

Notifies the listeners that the selected color has changed

setPopupStyle

public void setPopupStyle(AbstractColorPicker.PopupStyle style)

The style for the popup window

Parameters:

style - The style

setRGBVisibility

public void setRGBVisibility(boolean visible)

Set the visibility of the RGB Tab

Parameters:

visible - The visibility

setHSVVisibility

public void setHSVVisibility(boolean visible)

Set the visibility of the HSV Tab

Parameters:

visible - The visibility

setSwatchesVisibility

public void setSwatchesVisibility(boolean visible)

Set the visibility of the Swatches Tab

Parameters:

visible - The visibility

setHistoryVisibility

public void setHistoryVisibility(boolean visible)

Sets the visibility of the Color History

Parameters:

visible - The visibility

setTextfieldVisibility

public void setTextfieldVisibility(boolean visible)

Sets the visibility of the CSS color code text field

Parameters:

visible - The visibility

getState

protected com.vaadin.shared.ui.colorpicker.ColorPickerState getState()

Description copied from class: AbstractComponent

Returns the shared state bean with information to be sent from the server to the client. Subclasses should override this method and set any relevant fields of the state returned by super.getState().

Overrides:

getState in class AbstractComponent

Returns:

updated component shared state

setDefaultStyles

protected abstract void setDefaultStyles()

Sets the default styles of the component

showPopup

public void showPopup()

Shows a popup-window for color selection.

hidePopup

public void hidePopup()

Hides a popup-window for color selection.

showPopup

protected void showPopup(boolean open)

Shows or hides popup-window depending on the given parameter. If there is no such window yet, one is created.

Parameters:

open -

setHtmlContentAllowed

public void setHtmlContentAllowed(boolean htmlContentAllowed)

Set whether the caption text is rendered as HTML or not. You might need to re-theme component to allow higher content than the original text style. If set to true, the captions are passed to the browser as html and the developer is responsible for ensuring no harmful html is used. If set to false, the content is passed to the browser as plain text.

Parameters:

htmlContentAllowed - true if caption is rendered as HTML, false otherwise

isHtmlContentAllowed

public boolean isHtmlContentAllowed()

Return HTML rendering setting

Returns:

true if the caption text is to be rendered as HTML, false otherwise