javax.swing

Class JColorChooser

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JColorChooser

All Implemented Interfaces:

ImageObserver， MenuContainer， Serializable， Accessible

public class JColorChooser
extends JComponent
implements Accessible

JColorChooser提供一块设计为允许用户操作和选择颜色的控件。有关使用颜色选择，信息看 How to Use Color Choosers，java教程中的一部分。

这个类提供了三个级别的接口：

1. 一个静态的便利方法显示一个模态颜色选择器对话框并返回用户选择的颜色。
2. 一个静态的方便的方法创建一个颜色选择器对话框，ActionListeners可以指定被调用，当用户按下一个按钮的对话框。
3. 创造直接的JColorChooser窗格实例的能力（在任何容器）。PropertyChange听众可以被添加到检测时电流的“颜色”属性的变化。

警告： Swing是线程不安全的。更多信息见Swing's Threading Policy。

警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为1.4，为所有JavaBeans™长期存储的支持已被添加到java.beans包。请看XMLEncoder。

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	JColorChooser.AccessibleJColorChooser 这个类实现了对 JColorChooser类可访问性支持。

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.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
protected AccessibleContext	accessibleContext
static String	CHOOSER_PANELS_PROPERTY 的chooserpanel数组属性名称。
static String	PREVIEW_PANEL_PROPERTY 预览面板属性名称。
static String	SELECTION_MODEL_PROPERTY 选择模型属性名称。

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 and Description
JColorChooser() 创建一个白色的初始颜色选择器面板。
JColorChooser(Color initialColor) 创建一个具有指定的初始颜色选择器面板。
JColorChooser(ColorSelectionModel model) 创建一个具有指定 ColorSelectionModel颜色选择面板。

方法摘要

Modifier and Type	Method and Description
void	addChooserPanel(AbstractColorChooserPanel panel) 添加一个颜色选择面板颜色选择器。
static JDialog	createDialog(Component c, String title, boolean modal, JColorChooser chooserPane, ActionListener okListener, ActionListener cancelListener) 创建并返回一个新的对话框包含指定 ColorChooser窗格随着“确定”、“取消”和“重置”按钮。
AccessibleContext	getAccessibleContext() 获取与此相关的accessiblecontext jcolorchooser。
AbstractColorChooserPanel[]	getChooserPanels() 返回指定的颜色面板。
Color	getColor() 从颜色选择器控件的当前颜色值。
boolean	getDragEnabled() 得到的 dragEnabled属性的值。
JComponent	getPreviewPanel() 返回显示选定颜色的预览面板。
ColorSelectionModel	getSelectionModel() 返回处理颜色选择的数据模型。
ColorChooserUI	getUI() 返回呈现此组件的L和F对象。
String	getUIClassID() 返回呈现此组件的“L”和“F”类的名称。
protected String	paramString() 返回该 JColorChooser字符串表示形式。
AbstractColorChooserPanel	removeChooserPanel(AbstractColorChooserPanel panel) 移除指定的颜色面板。
void	setChooserPanels(AbstractColorChooserPanel[] panels) 指定用于选择颜色值的颜色面板。
void	setColor(Color color) 设置为指定的颜色选择器的当前颜色。
void	setColor(int c) 设置为指定的颜色选择器的当前颜色。
void	setColor(int r, int g, int b) 设置指定的RGB颜色的颜色选择器中的当前颜色。
void	setDragEnabled(boolean b) 集 dragEnabled财产，必须 true启用自动处理（拖动拖放第一部分）对该组件。
void	setPreviewPanel(JComponent preview) 设置当前预览面板。
void	setSelectionModel(ColorSelectionModel newModel) 设置包含所选颜色的模型。
void	setUI(ColorChooserUI ui) 设置呈现此组件的“L”和F对象。
static Color	showDialog(Component component, String title, Color initialColor) 显示一个模态的颜色选择器对话框和块直到对话框被隐藏。
void	updateUI() 从 UIManager，L和F改变通知。

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, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, 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, 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, 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, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

SELECTION_MODEL_PROPERTY

public static final String SELECTION_MODEL_PROPERTY

选择模型属性名称。

另请参见：

Constant Field Values

PREVIEW_PANEL_PROPERTY

public static final String PREVIEW_PANEL_PROPERTY

预览面板属性名称。

另请参见：

Constant Field Values

CHOOSER_PANELS_PROPERTY

public static final String CHOOSER_PANELS_PROPERTY

的chooserpanel数组属性名称。

另请参见：

Constant Field Values

accessibleContext

protected AccessibleContext accessibleContext

Constructor Detail

JColorChooser

public JColorChooser()

创建一个白色的初始颜色选择器面板。

JColorChooser

public JColorChooser(Color initialColor)

创建一个具有指定的初始颜色选择器面板。

参数

initialColor集的初始颜色选择器

JColorChooser

public JColorChooser(ColorSelectionModel model)

创建一个具有指定 ColorSelectionModel颜色选择面板。

参数

model - ColorSelectionModel用于

方法详细信息

showDialog

public static Color showDialog(Component component,
                               String title,
                               Color initialColor)
                        throws HeadlessException

显示一个模态的颜色选择器对话框和块直到对话框被隐藏。如果用户按下“确定”按钮，那么这个方法隐藏/配置对话框并返回选定的颜色。如果用户按下“取消”按钮或关闭不按“确定”的对话框，那么这种方法隐藏/配置对话框并返回 null。

参数

component为对话框的父 Component

title含有对话框的标题字符串

initialColor -初始设置颜色时，颜色选择器中显示

结果

选择的颜色或 null如果用户选择退出

异常

HeadlessException -如果graphicsenvironment isheadless()返回true。

另请参见：

GraphicsEnvironment.isHeadless()

createDialog

public static JDialog createDialog(Component c,
                                   String title,
                                   boolean modal,
                                   JColorChooser chooserPane,
                                   ActionListener okListener,
                                   ActionListener cancelListener)
                            throws HeadlessException

创建并返回一个新的对话框包含指定 ColorChooser窗格随着“确定”、“取消”和“重置”按钮。如果“确定”或“取消”按钮被按下，对话框会自动隐藏（但未设置）。如果“复位”按钮，颜色选择器的颜色将被重置为颜色这是最后一次 show在对话框和对话框的调用将显示。

参数

c为对话框的父组件

title -对话框的标题

modal -布尔。当真正的，该程序的其余部分是无效的，直到对话框关闭。

chooserPane -颜色选择器将里面的对话

okListener - action调用时，“确定”按

cancelListener - action调用时，“取消”压

结果

一种新的颜色选择器对话框包含窗格

异常

HeadlessException -如果graphicsenvironment isheadless()返回true。

另请参见：

GraphicsEnvironment.isHeadless()

getUI

public ColorChooserUI getUI()

返回呈现此组件的L和F对象。

结果

的 ColorChooserUI对象，使得这部分

setUI

public void setUI(ColorChooserUI ui)

设置呈现此组件的“L”和F对象。

参数

ui - ColorChooserUI L和F的对象

另请参见：

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

从 UIManager，L和F改变通知。从 UIManager最新版本替换当前的UI对象。

重写：

updateUI 方法重写，继承类 JComponent

另请参见：

JComponent.updateUI()

getUIClassID

public String getUIClassID()

返回呈现此组件的“L”和“F”类的名称。

重写：

getUIClassID 方法重写，继承类 JComponent

结果

字符串“colorchooserui”

另请参见：

JComponent.getUIClassID()， UIDefaults.getUI(javax.swing.JComponent)

getColor

public Color getColor()

从颜色选择器控件的当前颜色值。默认情况下，此委托给模型。

结果

的当前颜色值的颜色选择器

setColor

public void setColor(Color color)

设置为指定的颜色选择器的当前颜色。的 ColorSelectionModel将火 ChangeEvent

参数

color的颜色被设置在颜色选择器

另请参见：

Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

setColor

public void setColor(int r,
                     int g,
                     int b)

设置指定的RGB颜色的颜色选择器中的当前颜色。请注意，红，绿，蓝的值应该在255和0之间，包括。

参数

r指定红包金额int

g指定绿量int

b指定蓝量int

异常

IllegalArgumentException如果R、G、B值超出范围

另请参见：

Color

setColor

public void setColor(int c)

设置为指定的颜色选择器的当前颜色。

参数

c -一个整数值，在低阶8位指定的蓝色值选择器设置当前颜色，接下来的8位指定的绿色价值，和8位以上指定的红色值。

setDragEnabled

public void setDragEnabled(boolean b)

集 dragEnabled财产，必须 true启用自动处理（拖动拖放第一部分）对该组件。的 transferHandler属性必须设置为非为拖去做任何 null价值。该 dragEnabled属性的默认值是 false。

当启用自动拖动处理时，当用户按下预览面板上的鼠标按钮时，大多数的外观和感觉开始拖放操作。一些看起来和感觉可能不支持自动拖放，他们会忽略这个属性。你可以工作在这样的外观和感觉通过修改组件直接调用一个方法的exportAsDrag TransferHandler。

参数

b -设置 dragEnabled属性的值

异常

HeadlessException -如果 b是 true和 GraphicsEnvironment.isHeadless()返回 true

从以下版本开始：

一点四

另请参见：

GraphicsEnvironment.isHeadless()， getDragEnabled()， JComponent.setTransferHandler(javax.swing.TransferHandler)， TransferHandler

getDragEnabled

public boolean getDragEnabled()

得到的 dragEnabled属性的值。

结果

该 dragEnabled属性的值

从以下版本开始：

一点四

另请参见：

setDragEnabled(boolean)

setPreviewPanel

public void setPreviewPanel(JComponent preview)

设置当前预览面板。这一 PropertyChangeEvent火属性的命名为“previewpanel”。

参数

preview -显示当前颜色的 JComponent

另请参见：

Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

getPreviewPanel

public JComponent getPreviewPanel()

返回显示选定颜色的预览面板。

结果

一个 JComponent对象--预览面板

addChooserPanel

public void addChooserPanel(AbstractColorChooserPanel panel)

添加一个颜色选择面板颜色选择器。

参数

panel - AbstractColorChooserPanel加以补充

removeChooserPanel

public AbstractColorChooserPanel removeChooserPanel(AbstractColorChooserPanel panel)

移除指定的颜色面板。

参数

panel -一个字符串，指定要删除的面板

结果

颜色面板

异常

IllegalArgumentException如果面板不是已知的选择器面板列表

setChooserPanels

public void setChooserPanels(AbstractColorChooserPanel[] panels)

指定用于选择颜色值的颜色面板。

参数

panels - AbstractColorChooserPanel对象数组

getChooserPanels

public AbstractColorChooserPanel[] getChooserPanels()

返回指定的颜色面板。

结果

对 AbstractColorChooserPanel对象数组

getSelectionModel

public ColorSelectionModel getSelectionModel()

返回处理颜色选择的数据模型。

结果

一个 ColorSelectionModel对象

setSelectionModel

public void setSelectionModel(ColorSelectionModel newModel)

设置包含所选颜色的模型。

参数

newModel -新的 ColorSelectionModel对象

paramString

protected String paramString()

返回该 JColorChooser字符串表示形式。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null。

重写：

paramString 方法重写，继承类 JComponent

结果

这 JColorChooser字符串表示形式

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此相关的accessiblecontext jcolorchooser。颜色选择，以一个accessiblejcolorchooser的accessiblecontext形式。一个新的accessiblejcolorchooser实例被创建时。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 Component

结果

一个accessiblejcolorchooser作为本JColorChooser的accessiblecontext