Класс JColorChooser

javax.swing.JColorChooser

Все реализуемые интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible

@JavaBean(defaultProperty="UI", description="A component that supports selecting a Color.") public class JColorChooser extends JComponent implements Accessible

JColorChooser предоставляет панель элементов управления, предназначенную для выбора и настройки цвета пользователем. Сведения об использовании средств выбора цвета см. в разделе Использование средств выбора цвета в Учебнике по Java.

Этот класс предоставляет API трёх уровней:

Статический вспомогательный метод, который отображает модальное диалоговое окно выбора цвета и возвращает цвет, выбранный пользователем.
Статический вспомогательный метод для создания диалогового окна выбора цвета, в котором можно задать ActionListeners, вызываемый при нажатии пользователем одной из кнопок диалогового окна.
Возможность создавать экземпляры панелей JColorChooser непосредственно (в любом контейнере). Можно добавлять слушатели PropertyChange для обнаружения изменений текущего свойства "color".

Предупреждение: Swing не является потокобезопасным. Дополнительные сведения см. в разделе Политика Swing в отношении потоков.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для кратковременного хранения или использования RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4 в пакете java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.

Начиная с версии:: 1.2

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`JColorChooser.AccessibleJColorChooser`	Этот класс реализует поддержку специальных возможностей для класса `JColorChooser`.

Вложенные классы и интерфейсы, объявленные в классе JComponent

JComponent.AccessibleJComponent

Вложенные классы и интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer

Вложенные классы и интерфейсы, объявленные в классе Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected AccessibleContext`	`accessibleContext`	Контекст специальных возможностей.
`static final String`	`CHOOSER_PANELS_PROPERTY`	Имя свойства массива chooserPanel.
`static final String`	`PREVIEW_PANEL_PROPERTY`	Имя свойства панели предварительного просмотра.
`static final String`	`SELECTION_MODEL_PROPERTY`	Имя свойства модели выбора.

Поля, объявленные в классе JComponent

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

Поля, объявленные в классе Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе ImageObserver

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

Краткое описание конструкторов

Конструктор	Описание
`JColorChooser()`	Создаёт панель выбора цвета с начальным цветом — белым.
`JColorChooser(Color initialColor)`	Создаёт панель выбора цвета с указанным начальным цветом.
`JColorChooser(ColorSelectionModel model)`	Создаёт панель выбора цвета с указанным `ColorSelectionModel`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`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(int c)`	Задаёт текущий цвет средства выбора цвета, используя указанный цвет.
`void`	`setColor(int r, int g, int b)`	Задаёт текущий цвет средства выбора цвета, используя указанный цвет RGB.
`void`	`setColor(Color color)`	Задаёт текущий цвет средства выбора цвета, используя указанный цвет.
`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)`	Отображает модальное диалоговое окно выбора цвета и блокирует выполнение до его скрытия.
`static Color`	`showDialog(Component component, String title, Color initialColor, boolean colorTransparencySelectionEnabled)`	Отображает модальное диалоговое окно выбора цвета и блокирует выполнение до его скрытия.
`void`	`updateUI()`	Уведомление от `UIManager` об изменении L&F.

Методы, объявленные в классе JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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, 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, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе Object

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

Подробное описание полей

SELECTION_MODEL_PROPERTY

public static final String SELECTION_MODEL_PROPERTY

Имя свойства модели выбора.

См. также:

PREVIEW_PANEL_PROPERTY

public static final String PREVIEW_PANEL_PROPERTY

Имя свойства панели предварительного просмотра.

См. также:

CHOOSER_PANELS_PROPERTY

public static final String CHOOSER_PANELS_PROPERTY

Имя свойства массива chooserPanel.

См. также:

accessibleContext

protected AccessibleContext accessibleContext

Контекст специальных возможностей.

Подробное описание конструкторов

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.

См. также:

showDialog

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

Параметры:

component — родительский Component для диалогового окна

title — строка с заголовком диалогового окна

initialColor — начальный цвет, задаваемый при отображении средства выбора цвета

colorTransparencySelectionEnabled — true, если можно выбирать прозрачность цвета

Возвращает:

выбранный цвет или null, если пользователь отказался от выбора

Выбрасывает:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true.

Начиная с версии:

См. также:

createDialog

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

Создаёт и возвращает новое диалоговое окно, содержащее указанную панель ColorChooser и кнопки «ОК», «Отмена» и «Сброс». При нажатии кнопки «ОК» или «Отмена» диалоговое окно автоматически скрывается (но не закрывается). При нажатии кнопки «Сброс» цвет средства выбора цвета сбрасывается к цвету, установленному при последнем вызове show для этого диалогового окна, которое остаётся видимым.

Параметры:

c — родительский компонент для диалогового окна

title — заголовок диалогового окна

modal — логическое значение. Если true, остальная часть программы неактивна, пока диалоговое окно не будет закрыто.

chooserPane — средство выбора цвета, которое нужно поместить в диалоговое окно

okListener — ActionListener, вызываемый при нажатии «ОК»

cancelListener — ActionListener, вызываемый при нажатии «Отмена»

Возвращает:

новое диалоговое окно, содержащее панель выбора цвета

Выбрасывает:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

getUI

public ColorChooserUI getUI()

Возвращает объект L&F, который отображает этот компонент.

Переопределяет:: getUI в классе JComponent
Возвращает:: объект ColorChooserUI, который отображает этот компонент

setUI

@BeanProperty(hidden=true, description="The UI object that implements the color chooser's LookAndFeel.") public void setUI(ColorChooserUI ui)

Задаёт объект L&F, который отображает этот компонент.

Параметры:

ui — объект L&F ColorChooserUI

См. также:

updateUI

public void updateUI()

Уведомление от UIManager об изменении L&F. Заменяет текущий объект UI последней версией из UIManager.

Переопределяет:

updateUI в классе JComponent

См. также:

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

Возвращает имя класса L&F, который отображает этот компонент.

Переопределяет:

getUIClassID в классе JComponent

Возвращает:

строку "ColorChooserUI"

См. также:

getColor

public Color getColor()

Получает текущее значение цвета из средства выбора цвета. По умолчанию этот метод делегирует выполнение модели.

Возвращает:: текущее значение цвета средства выбора цвета

setColor

@BeanProperty(bound=false, description="The current color the chooser is to display.") public void setColor(Color color)

Задаёт текущий цвет средства выбора цвета, используя указанный цвет. ColorSelectionModel вызовет ChangeEvent

Параметры:

color — цвет, который нужно задать в средстве выбора цвета

См. также:

setColor

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

Задаёт текущий цвет средства выбора цвета, используя указанный цвет RGB. Обратите внимание, что значения красного, зелёного и синего компонентов должны находиться в диапазоне от 0 до 255 включительно.

Параметры:

r — значение типа int, задающее количество красного

g — значение типа int, задающее количество зелёного

b — значение типа int, задающее количество синего

Выбрасывает:

IllegalArgumentException — если значения r, g, b выходят за допустимый диапазон

См. также:

setColor

public void setColor(int c)

Задаёт текущий цвет средства выбора цвета, используя указанный цвет.

Параметры:: c — целочисленное значение, задающее текущий цвет в средстве выбора: младшие 8 бит задают значение синего компонента, следующие 8 бит — зелёного, а следующие за ними 8 бит — красного.

setDragEnabled

@BeanProperty(bound=false, description="Determines whether automatic drag handling is enabled.") public void setDragEnabled(boolean b)

Задаёт свойство dragEnabled, которому должно быть присвоено значение true, чтобы включить автоматическую обработку перетаскивания (первой части операции перетаскивания) для этого компонента. Для выполнения перетаскивания свойству transferHandler необходимо присвоить значение, отличное от null. Значение свойства dragEnabled по умолчанию — false.

При включённой автоматической обработке перетаскивания большинство реализаций внешнего вида и поведения начинает операцию перетаскивания, когда пользователь нажимает кнопку мыши над панелью предварительного просмотра. Некоторые реализации внешнего вида и поведения могут не поддерживать автоматическое перетаскивание и будут игнорировать это свойство. Для таких реализаций можно обойти это ограничение, изменив компонент так, чтобы он непосредственно вызывал метод exportAsDrag объекта TransferHandler.

Параметры:

b — значение, которое нужно присвоить свойству dragEnabled

Выбрасывает:

HeadlessException — если b имеет значение true и GraphicsEnvironment.isHeadless() возвращает true

Начиная с версии:

1.4

См. также:

getDragEnabled

public boolean getDragEnabled()

Получает значение свойства dragEnabled.

Возвращает:

значение свойства dragEnabled

Начиная с версии:

1.4

См. также:

setPreviewPanel

@BeanProperty(hidden=true, description="The UI component which displays the current color.") public void setPreviewPanel(JComponent preview)

Задаёт текущую панель предварительного просмотра. Это вызовет PropertyChangeEvent для свойства с именем "previewPanel".

Параметры:

preview — JComponent, отображающий текущий цвет

См. также:

getPreviewPanel

public JComponent getPreviewPanel()

Возвращает панель предварительного просмотра, отображающую выбранный цвет.

Возвращает:: объект JComponent — панель предварительного просмотра

addChooserPanel

public void addChooserPanel(AbstractColorChooserPanel panel)

Добавляет панель выбора цвета в средство выбора цвета.

Параметры:: panel — добавляемая AbstractColorChooserPanel

removeChooserPanel

public AbstractColorChooserPanel removeChooserPanel(AbstractColorChooserPanel panel)

Удаляет указанную панель цвета.

Параметры:: panel — строка, указывающая удаляемую панель
Возвращает:: панель цвета
Выбрасывает:: IllegalArgumentException — если панели нет в списке известных панелей выбора цвета

setChooserPanels

@BeanProperty(hidden=true, description="An array of different chooser types.") public void setChooserPanels(AbstractColorChooserPanel[] panels)

Задаёт панели цвета, используемые для выбора значения цвета.

Параметры:: panels — массив объектов AbstractColorChooserPanel

getChooserPanels

public AbstractColorChooserPanel[] getChooserPanels()

Возвращает указанные панели выбора цвета.

Возвращает:: массив объектов AbstractColorChooserPanel

getSelectionModel

public ColorSelectionModel getSelectionModel()

Возвращает модель данных, обрабатывающую выбор цвета.

Возвращает:: объект ColorSelectionModel

setSelectionModel

@BeanProperty(hidden=true, description="The model which contains the currently selected color.") public void setSelectionModel(ColorSelectionModel newModel)

Задаёт модель, содержащую выбранный цвет.

Параметры:: newModel — новый объект ColorSelectionModel

paramString

protected String paramString()

Возвращает строковое представление этого JColorChooser. Этот метод предназначен только для отладки; содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.

Переопределяет:: paramString в классе JComponent
Возвращает:: строковое представление этого JColorChooser

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим JColorChooser. Для средств выбора цвета AccessibleContext имеет вид AccessibleJColorChooser. При необходимости создаётся новый экземпляр AccessibleJColorChooser.

Определён в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: AccessibleJColorChooser, выполняющий роль AccessibleContext этого JColorChooser

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JColorChooser.html