oracle.ide.controls
Class CustomColorChoice

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.AbstractButton
                  javax.swing.JButton
                      oracle.bali.ewt.chooser.color.ColorChoice
                          oracle.ide.controls.CustomColorChoice

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.ItemSelectable, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, javax.swing.SwingConstants

public class CustomColorChoice
extends oracle.bali.ewt.chooser.color.ColorChoice

The CustomColorChoice is an extension of the Bali ColorChoice with default options set to show a custom palette with editable colors. This class takes care of persisting the custom colors through the Ide's DTCache instance. It also uses a shared custom palette, so that when the user edits a custom color, it is automatically seen by other CustomColorChoice instances.

If the custom palette is empty, it will pre-fill any null colors with light gray. This is because there doesn't seem to be a way to disallow null colors from being seleted in the control.

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JButton.AccessibleJButton

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

javax.swing.AbstractButton.AccessibleAbstractButton, javax.swing.AbstractButton.ButtonChangeListener

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

javax.swing.JComponent.AccessibleJComponent

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

java.awt.Container.AccessibleAWTContainer

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

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

static oracle.bali.ewt.model.TwoDModel

DEFAULT_SWATCH_MODEL The 2D model instance that can be used with Bali's color choosers, based on our default color swatch.

Fields inherited from class oracle.bali.ewt.chooser.color.ColorChoice

PROPERTY_AUTOMATIC_SELECTED, PROPERTY_COLOR_PALETTE, PROPERTY_CUSTOM_COLOR_NAMES, PROPERTY_DEFAULT_SELECTED, PROPERTY_POPUP_VISIBLE, PROPERTY_SELECTED_COLOR, RGB_HEX_TOOLTIP, RGB_TOOLTIP

Fields inherited from class javax.swing.AbstractButton

actionListener, BORDER_PAINTED_CHANGED_PROPERTY, changeEvent, changeListener, CONTENT_AREA_FILLED_CHANGED_PROPERTY, DISABLED_ICON_CHANGED_PROPERTY, DISABLED_SELECTED_ICON_CHANGED_PROPERTY, FOCUS_PAINTED_CHANGED_PROPERTY, HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY, HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY, ICON_CHANGED_PROPERTY, itemListener, MARGIN_CHANGED_PROPERTY, MNEMONIC_CHANGED_PROPERTY, model, MODEL_CHANGED_PROPERTY, PRESSED_ICON_CHANGED_PROPERTY, ROLLOVER_ENABLED_CHANGED_PROPERTY, ROLLOVER_ICON_CHANGED_PROPERTY, ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY, SELECTED_ICON_CHANGED_PROPERTY, TEXT_CHANGED_PROPERTY, VERTICAL_ALIGNMENT_CHANGED_PROPERTY, VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

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 javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

CustomColorChoice()
Construct a new CustomColorChoice.

Method Summary

oracle.bali.ewt.chooser.color.CustomColorPane	getCustomColorPane()
protected static oracle.bali.ewt.model.TwoDModel	getCustomPalette() Fetch the custom palette of user-specified colors that can be used for the color choice.
protected static boolean	isColorInPalette(java.awt.Color color, oracle.bali.ewt.model.TwoDModel palette) Utility routine to check if a given color is contained within the given palette.
protected static void	loadPalette(oracle.bali.ewt.model.TwoDModel palette) Utility routine to load the colors for the custom palette from the DTCache area.
protected static void	savePalette(oracle.bali.ewt.model.TwoDModel palette) Utility routine to save the colors from the specified palette back to the DTCache area.
void	setClosestSelectedColor(java.awt.Color color) Selects the specified color, whether it is in the main or custom palette, or the closest color if it is not available in either.

Methods inherited from class oracle.bali.ewt.chooser.color.ColorChoice

dispose, firePropertyChange, getAccessibleContext, getClosestColor, getClosestColor, getColorPalette, getColorPalettePane, getColorToChange, getCustomColorName, getCustomColorNames, getCustomColorPalette, getDefaultColor, getImage, getSelectedColor, getToolTipMode, isAutomaticAllowed, isAutomaticSelected, isColorInPalette, isCustomColorPaneSupported, isCustomColorSelected, isDefaultAllowed, isDefaultSelected, isEditAllowed, isPopupVisible, isTransparentAllowed, isTransparentLabelUsed, removeNotify, setAutomaticAllowed, setAutomaticSelected, setColorPalette, setCustomColorNames, setCustomColorPalette, setCustomColorPaneSupported, setDefaultAllowed, setDefaultColor, setDefaultSelected, setDisabledIcon, setEditAllowed, setEnabled, setIcon, setImage, setLocale, setSelectedColor, setSelectedColor, setToolTipMode, setTransparentAllowed, setTransparentLabelUsed, updateUI

Methods inherited from class javax.swing.JButton

getUIClassID, isDefaultButton, isDefaultCapable, paramString, setDefaultCapable

Methods inherited from class javax.swing.AbstractButton

actionPropertyChanged, addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, configurePropertiesFromAction, createActionListener, createActionPropertyChangeListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, getHideActionText, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getIconTextGap, getItemListeners, getLabel, getMargin, getMnemonic, getModel, getMultiClickThreshhold, getPressedIcon, getRolloverIcon, getRolloverSelectedIcon, getSelectedIcon, getSelectedObjects, getText, getUI, getVerticalAlignment, getVerticalTextPosition, imageUpdate, init, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setFocusPainted, setHideActionText, setHorizontalAlignment, setHorizontalTextPosition, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setModel, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition

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, getBaseline, getBaselineResizeBehavior, 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, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, 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, 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, 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, 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, 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, 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

Field Detail

DEFAULT_SWATCH_MODEL

public static final oracle.bali.ewt.model.TwoDModel DEFAULT_SWATCH_MODEL

The 2D model instance that can be used with Bali's color choosers, based on our default color swatch.

Constructor Detail

CustomColorChoice

public CustomColorChoice()

Construct a new CustomColorChoice. This will use the default web-safe color model along with a shared custom palette.

Method Detail

getCustomColorPane

public oracle.bali.ewt.chooser.color.CustomColorPane getCustomColorPane()

Overrides:

getCustomColorPane in class oracle.bali.ewt.chooser.color.ColorChoice

setClosestSelectedColor

public void setClosestSelectedColor(java.awt.Color color)

Selects the specified color, whether it is in the main or custom palette, or the closest color if it is not available in either.

Parameters:

color - the color to select

isColorInPalette

protected static boolean isColorInPalette(java.awt.Color color,
                                          oracle.bali.ewt.model.TwoDModel palette)

Utility routine to check if a given color is contained within the given palette.

Parameters:

color - the color to check

palette - the palette to check

Returns:

true if the specified color is contained in the palette

getCustomPalette

protected static oracle.bali.ewt.model.TwoDModel getCustomPalette()

Fetch the custom palette of user-specified colors that can be used for the color choice.

Returns:

the model for the custom palette

loadPalette

protected static void loadPalette(oracle.bali.ewt.model.TwoDModel palette)

Utility routine to load the colors for the custom palette from the DTCache area.

Parameters:

palette - the palette to load the colors into

savePalette

protected static void savePalette(oracle.bali.ewt.model.TwoDModel palette)

Utility routine to save the colors from the specified palette back to the DTCache area.

Parameters:

palette - the palette to the save the colors of