uic.widgets
Class ColorSelection

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  uic.widgets.ColorSelectionBase
                      uic.widgets.ColorSelection

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

public class ColorSelection
extends ColorSelectionBase

A color selection dialog. This selection dialog aims to provide a selector much like the one used on various operating systems to make the user feel at home.

Since:

1.1

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class uic.widgets.ColorSelectionBase

bAdd, bAddAction, blueSpin, bPick, bPickAction, colorPanel, greenSpin, HSV, htmlLineEdit, hueSpin, previewPanel, previewType, redSpin, saturationSpin, selector, tabs, textLabel1, textLabel1_2, textLabel1_3, textLabel1_4, textLabel1_5, textLabel1_6, textLabel2, valueSpin

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

ColorSelection()
Create a new ColorSelection widget with the default color 'white'.

ColorSelection(Color start)
Create a new ColorSelection widget which preselects the argument color.

Method Summary

void	addPreviewPane(String name, ColorButtons cb) Add a set of color-swatches in the form of a ColorButtons instance to this selector.
void	bAddPressedSlot() Called when the user pressed the 'add to...' button.
void	bPickPressedSlot()
Color	getColor() Returns the current selected color.
void	hsvSpinnerChangedSlot() Is called when the user changes any hsv spinner.
void	htmlColorChangedSlot(String input) Is called when the user changes the html color text.
protected void	previewTypeSelectedSlot(uic.widgets.ColorSelection.ColorButtonsWrapper buttons)
void	rgbSpinnerChangedSlot() Is called when the user changes any rgb spinner.
static Color	selectColorDialog(Window parent, Color selected) Show a color selection dialog with the argument color as a proposal.
void	setColor(Color newColor) Set a color for this widget to display.
TranslationInterface	translate()
protected void	updateColorSlot(Color newColor) Is called when the user clicks on a color.

Methods inherited from class uic.widgets.ColorSelectionBase

guiInit

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

ColorSelection

public ColorSelection()

Create a new ColorSelection widget with the default color 'white'.

ColorSelection

public ColorSelection(Color start)

Create a new ColorSelection widget which preselects the argument color.

Parameters:

start - the color to select on start.

Method Detail

addPreviewPane

public void addPreviewPane(String name,
                           ColorButtons cb)

Add a set of color-swatches in the form of a ColorButtons instance to this selector. On the ColorSelection widget the right part is reserved for previously shown colors in the form of a "Recent Colors" array of color-buttons. By adding another ColorButtons instance using this method the user gets an additional entry in the combobox to show yours. You are responsible to do some kind of persistency if that is required.

updateColorSlot

protected void updateColorSlot(Color newColor)

Is called when the user clicks on a color.

rgbSpinnerChangedSlot

public void rgbSpinnerChangedSlot()

Is called when the user changes any rgb spinner.

hsvSpinnerChangedSlot

public void hsvSpinnerChangedSlot()

Is called when the user changes any hsv spinner.

htmlColorChangedSlot

public void htmlColorChangedSlot(String input)

Is called when the user changes the html color text.

getColor

public Color getColor()

Returns the current selected color.

Returns:

the current selected color.

setColor

public void setColor(Color newColor)

Set a color for this widget to display.

selectColorDialog

public static Color selectColorDialog(Window parent,
                                      Color selected)

Show a color selection dialog with the argument color as a proposal.

Parameters:

parent - a parent that will be blocked while this dialog is open.

selected - the proposal color.

Returns:

the newly selected color or the selected color if the user cancelled.

bAddPressedSlot

public void bAddPressedSlot()

Called when the user pressed the 'add to...' button.

Overrides:

bAddPressedSlot in class ColorSelectionBase

bPickPressedSlot

public void bPickPressedSlot()

Overrides:

bPickPressedSlot in class ColorSelectionBase

previewTypeSelectedSlot

protected void previewTypeSelectedSlot(uic.widgets.ColorSelection.ColorButtonsWrapper buttons)

translate

public TranslationInterface translate()

Overrides:

translate in class ColorSelectionBase