Класс 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 для обнаружения изменений текущего свойства "цвет".

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

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

С тех пор как:: 1.2

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

Модификатор и тип	Класс	Описание
`protected class`	`JColorChooser.AccessibleJColorChooser`	Этот класс реализует поддержку доступности для класса `JColorChooser`.

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе java.awt.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`	Имя свойства модели выбора.

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

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

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

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе java.awt.image.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` панель наряду с кнопками "OK", "Отмена" и "Сброс".
`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 изменился.

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

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

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

Методы, объявленные в классе java.lang.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 - целое число, указывающее количество красного

g - целое число, указывающее количество зеленого

b - целое число, указывающее количество синего

Исключения:

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.

При включенной автоматической обработке перетаскивания большинство визуальных стилей (look and feels) начинают операцию перетаскивания и перемещения, когда пользователь нажимает кнопку мыши над панелью предварительного просмотра. Некоторые визуальные стили могут не поддерживать автоматическое перетаскивание и перемещение; в таком случае они проигнорируют это свойство. Вы можете обойти такую ситуацию, модифицировав компонент для прямого вызова метода exportAsDrag объекта TransferHandler.

Parameters:

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

Throws:

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

Since:

1.4

See Also:

getDragEnabled

public boolean getDragEnabled()

Возвращает значение свойства dragEnabled.

Returns:

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

Since:

1.4

See Also:

setPreviewPanel

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

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

Parameters:

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

See Also:

getPreviewPanel

public JComponent getPreviewPanel()

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

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

addChooserPanel

public void addChooserPanel(AbstractColorChooserPanel panel)

Добавляет панель выбора цвета к диалоговому окну выбора цвета.

Parameters:: panel - AbstractColorChooserPanel для добавления

removeChooserPanel

public AbstractColorChooserPanel removeChooserPanel(AbstractColorChooserPanel panel)

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

Parameters:: panel - строка, определяющая удаляемую панель
Returns:: панель выбора цвета
Throws:: IllegalArgumentException - если панель не содержится в списке известных панелей выбора цвета

setChooserPanels

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

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

Parameters:: panels - массив объектов AbstractColorChooserPanel

getChooserPanels

public AbstractColorChooserPanel[] getChooserPanels()

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

Returns:: массив объектов AbstractColorChooserPanel

getSelectionModel

public ColorSelectionModel getSelectionModel()

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

Returns:: объект ColorSelectionModel

setSelectionModel

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

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

Parameters:: newModel - новый объект ColorSelectionModel

paramString

protected String paramString()

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

Overrides:: paramString в классе JComponent
Returns:: строковое представление этого JColorChooser

getAccessibleContext

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

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

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Returns:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JColorChooser.html