javax.swing

Класс JColorChooser

java.lang. Объект

java.awt. Компонент

java.awt. Контейнер

javax.swing. JComponent

javax.swing. JColorChooser

Все Реализованные Интерфейсы:

ImageObserver, MenuContainer, Сериализуемый, Доступный

public class JColorChooser
extends JComponent
implements Accessible

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

Этот class обеспечивает три уровня API:

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

Предупреждение: Swing не ориентирован на многопотоковое исполнение. Для получения дополнительной информации см., что Swing Распараллеливает Политику.

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

Вложенная Сводка Класса

Вложенные Классы

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

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

JComponent. AccessibleJComponent

Вложенные классы/интерфейсы, наследованные от class java.awt. Контейнер

Контейнер. AccessibleAWTContainer

Вложенные классы/интерфейсы, наследованные от class java.awt. Компонент

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

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected AccessibleContext	accessibleContext
static String	CHOOSER_PANELS_PROPERTY chooserPanel выстраивают имя свойства.
static String	PREVIEW_PANEL_PROPERTY Имя свойства панели предварительного просмотра.
static String	SELECTION_MODEL_PROPERTY Имя свойства модели выбора.

Поля, наследованные от class javax.swing. JComponent

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

Поля, наследованные от class java.awt. Компонент

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", "Отменой", и кнопками "Reset".
AccessibleContext	getAccessibleContext() Связали AccessibleContext с этим JColorChooser.
AbstractColorChooserPanel[]	getChooserPanels() Возвращает указанные цветные панели.
Цвет	getColor() Получает текущее значение цвета от цветного селектора.
boolean	getDragEnabled() Получает значение dragEnabled свойство.
JComponent	getPreviewPanel() Возвращает панель предварительного просмотра, которая показывает выбранный цвет.
ColorSelectionModel	getSelectionModel() Возвращает модель данных, которая обрабатывает цветные выборы.
ColorChooserUI	getUI() Возвращается L&F объект, который представляет этот компонент.
Строка	getUIClassID() Возвращает имя L&F class, который представляет этот компонент.
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 изменился.

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

Методы, наследованные от class java.awt. Контейнер

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

Методы, наследованные от class java.awt. Компонент

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

Методы, наследованные от class java.lang. Объект

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

Показывает модальное диалоговое окно цветного селектора и блоки, пока диалоговое окно не скрывается. Если пользователь нажимает кнопку "OK", то этот метод, hides/disposes диалоговое окно и, возвращает выбранный цвет. Если пользователь нажимает кнопку "Cancel" или закрывает диалоговое окно, не нажимая "OK", то этот метод, hides/disposes диалоговое окно и возвраты null.

Параметры:

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

title - Строка, содержащая 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 область наряду с "OK", "Отменой", и кнопками "Reset". Если кнопки "OK" или "Cancel" нажимаются, диалоговое окно автоматически скрывается (но не располагается). Если кнопка "Reset" будет нажата, то цвет цветного селектора будет сброшен к цвету, который был выбран в прошлый раз show был вызван на диалоговое окно, и диалоговое окно останется показывать.

Параметры:

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

title - title для диалогового окна

modal - булево. Когда истина, остаток от программы неактивен, пока диалоговое окно не закрывается.

chooserPane - цветной селектор, который будет помещен в диалоговом окне

okListener - ActionListener вызвал, когда "OK" нажимается

cancelListener - ActionListener вызвал, когда "Отмена" нажимается

Возвраты:

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

Броски:

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 изменился. Заменяет текущий объект UI последней версией от UIManager.

Переопределения:

updateUI в class JComponent

См. Также:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

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

Переопределения:

getUIClassID в class JComponent

Возвраты:

строка "ColorChooserUI"

См. Также:

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

getColor

public Color getColor()

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

Возвраты:

текущее значение цвета цветного селектора

setColor

public void setColor(Color color)

Выбирает текущий цвет цветного селектора к указанному цвету. ColorSelectionModel запустит a ChangeEvent

Параметры:

color - цвет, который будет установлен в цветном селекторе

См. Также:

Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

setColor

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

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

Параметры:

r - интервал, определяющий количество Красных

g - интервал, определяющий количество Грина

b - интервал, определяющий количество Синих

Броски:

IllegalArgumentException - если r, г, 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 метод a TransferHandler.

Параметры:

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

Броски:

HeadlessException - если b true и GraphicsEnvironment.isHeadless() возвраты true

С тех пор:

1.4

См. Также:

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

getDragEnabled

public boolean getDragEnabled()

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

Возвраты:

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

С тех пор:

1.4

См. Также:

setDragEnabled(boolean)

setPreviewPanel

public void setPreviewPanel(JComponent preview)

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

Параметры:

preview - JComponent который выводит на экран текущий цвет

См. Также:

Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

getPreviewPanel

public JComponent getPreviewPanel()

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

Возвраты:

a 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()

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

Возвраты:

a ColorSelectionModel объект

setSelectionModel

public void setSelectionModel(ColorSelectionModel newModel)

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

Параметры:

newModel - новое ColorSelectionModel объект

paramString

protected String paramString()

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

Переопределения:

paramString в class JComponent

Возвраты:

строковое представление этого JColorChooser

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определенный:

getAccessibleContext в интерфейсе Accessible

Переопределения:

getAccessibleContext в class Component

Возвраты:

AccessibleJColorChooser, который служит AccessibleContext этого JColorChooser