|
JavaTM 2 Platform Std. Ed. v1.3.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JColorChooser
JColorChooser
provides a pane of controls designed to allow
a user to manipulate and select a color.
For information about using color choosers, see
How to Use Color Choosers,
a section in The Java Tutorial.
This class provides three levels of API:
ActionListeners
can be specified to be invoked when
the user presses one of the dialog buttons.
JColorChooser
panes
directly (within any container). PropertyChange
listeners
can be added to detect when the current "color" property changes.
Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. A future release of Swing will provide support for long term persistence.
Inner Class Summary | |
protected class |
JColorChooser.AccessibleJColorChooser
This class implements accessibility support for the JColorChooser class. |
Inner classes inherited from class javax.swing.JComponent |
JComponent.AccessibleJComponent |
Inner classes inherited from class java.awt.Container |
Container.AccessibleAWTContainer |
Inner classes inherited from class java.awt.Component |
Component.AccessibleAWTComponent |
Field Summary | |
protected AccessibleContext |
accessibleContext
|
static String |
CHOOSER_PANELS_PROPERTY
The chooserPanel array property name. |
static String |
PREVIEW_PANEL_PROPERTY
The preview panel property name. |
static String |
SELECTION_MODEL_PROPERTY
The selection model property name. |
Fields inherited from class javax.swing.JComponent |
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 | |
JColorChooser()
Creates a color chooser pane with an initial color of white. |
|
JColorChooser(Color initialColor)
Creates a color chooser pane with the specified initial color. |
|
JColorChooser(ColorSelectionModel model)
Creates a color chooser pane with the specified ColorSelectionModel . |
Method Summary | |
void |
addChooserPanel(AbstractColorChooserPanel panel)
Adds a color chooser panel to the color chooser. |
static JDialog |
createDialog(Component c,
String title,
boolean modal,
JColorChooser chooserPane,
ActionListener okListener,
ActionListener cancelListener)
Creates and returns a new dialog containing the specified ColorChooser ` pane along with "OK", "Cancel", and "Reset"
buttons. |
AccessibleContext |
getAccessibleContext()
Gets the AccessibleContext associated with this JColorChooser. |
AbstractColorChooserPanel[] |
getChooserPanels()
Returns the specified color panels. |
Color |
getColor()
Gets the current color value from the color chooser. |
JComponent |
getPreviewPanel()
Returns the preview panel that shows a chosen color. |
ColorSelectionModel |
getSelectionModel()
Returns the data model that handles color selections. |
ColorChooserUI |
getUI()
Returns the L&F object that renders this component. |
String |
getUIClassID()
Returns the name of the L&F class that renders this component. |
protected String |
paramString()
Returns a string representation of this JColorChooser . |
AbstractColorChooserPanel |
removeChooserPanel(AbstractColorChooserPanel panel)
Removes the Color Panel specified. |
void |
setChooserPanels(AbstractColorChooserPanel[] panels)
Specifies the Color Panels used to choose a color value. |
void |
setColor(Color color)
Sets the current color of the color chooser to the specified color. |
void |
setColor(int c)
Sets the current color of the color chooser to the specified color. |
void |
setColor(int r,
int g,
int b)
Sets the current color of the color chooser to the specified RGB color. |
void |
setPreviewPanel(JComponent preview)
Sets the current preview panel. |
void |
setSelectionModel(ColorSelectionModel newModel)
Set the model containing the selected color. |
void |
setUI(ColorChooserUI ui)
Sets the L&F object that renders this component. |
static Color |
showDialog(Component component,
String title,
Color initialColor)
Shows a modal color-chooser dialog and blocks until the dialog is hidden. |
void |
updateUI()
Notification from the UIManager that the L&F has changed. |
Methods inherited from class java.awt.Container |
add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
public static final String SELECTION_MODEL_PROPERTY
public static final String PREVIEW_PANEL_PROPERTY
public static final String CHOOSER_PANELS_PROPERTY
protected AccessibleContext accessibleContext
Constructor Detail |
public JColorChooser()
public JColorChooser(Color initialColor)
initialColor
- the initial color set in the chooserpublic JColorChooser(ColorSelectionModel model)
ColorSelectionModel
.initialColor
- the initial color set in the chooserMethod Detail |
public static Color showDialog(Component component, String title, Color initialColor)
null
.component
- the parent Component
for the dialogtitle
- the String containing the dialog's titleinitialColor
- the initial Color set when the color-chooser is shownpublic static JDialog createDialog(Component c, String title, boolean modal, JColorChooser chooserPane, ActionListener okListener, ActionListener cancelListener)
ColorChooser
` pane along with "OK", "Cancel", and "Reset"
buttons. If the "OK" or "Cancel" buttons are pressed, the dialog is
automatically hidden (but not disposed). If the "Reset"
button is pressed, the color-chooser's color will be reset to the
color which was set the last time show
was invoked on the
dialog and the dialog will remain showing.c
- the parent component for the dialogtitle
- the title for the dialogmodal
- a boolean. When true, the remainder of the program
is inactive until the dialog is closed.chooserPane
- the color-chooser to be placed inside the dialogokListener
- the ActionListener invoked when "OK" is pressedcancelListener
- the ActionListener invoked when "Cancel" is pressedpublic ColorChooserUI getUI()
public void setUI(ColorChooserUI ui)
ui
- the ColorChooserUI L&F objectUIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
UIManager
that the L&F has changed.
Replaces the current UI object with the latest version from the
UIManager
.updateUI
in class JComponent
JComponent.updateUI()
public String getUIClassID()
getUIClassID
in class JComponent
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public Color getColor()
public void setColor(Color color)
PropertyChangeEvent
for the property
named "color".color
- the color to be set in the color chooserJComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)
public void setColor(int r, int g, int b)
r
- an int specifying the amount of Redg
- an int specifying the amount of Greenb
- an int specifying the amount of BlueIllegalArgumentException
- if r,g,b values are out of rangeColor
public void setColor(int c)
c
- an int value that sets the current color in the chooser
where the low-order 8 bits specify the Blue value,
the next 8 bits specify the Green value, and the 8 bits
above that specify the Red value.public void setPreviewPanel(JComponent preview)
PropertyChangeEvent
for the property
named "previewPanel".color
- the color to be set in the color chooserJComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)
public JComponent getPreviewPanel()
public void addChooserPanel(AbstractColorChooserPanel panel)
public AbstractColorChooserPanel removeChooserPanel(AbstractColorChooserPanel panel)
name
- a string that specifies the panel to be removedIllegalArgumentException
- if panel is not in list of
known chooser panelspublic void setChooserPanels(AbstractColorChooserPanel[] panels)
panels
- an array of AbstractColorChooserPanel objectpublic AbstractColorChooserPanel[] getChooserPanels()
public ColorSelectionModel getSelectionModel()
public void setSelectionModel(ColorSelectionModel newModel)
newModel
- the new ColorSelectionModel objectprotected String paramString()
JColorChooser
.
This method
is intended to be used only for debugging purposes, and the
content and format of the returned string may vary between
implementations. The returned string may be empty but may not
be null
.paramString
in class JComponent
JColorChooser
public AccessibleContext getAccessibleContext()
getAccessibleContext
in interface Accessible
getAccessibleContext
in class JComponent
|
JavaTM 2 Platform Std. Ed. v1.3.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2001 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.