javax.swing

クラスJColorChooser

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JColorChooser

すべての実装されたインタフェース:

ImageObserver, MenuContainer, Serializable, Accessible

public class JColorChooser
extends JComponent
implements Accessible

JColorChooserは、ユーザーが色を操作したり、選択したりできるように設計されたコントロールのペインを提供します。カラー・チューザの使用については、『The Java Tutorial』の「How to Use Color Choosers」を参照してください。

このクラスは3つのレベルのAPIを提供します。

1. モーダルなカラー・チューザ・ダイアログを表示し、ユーザーが選択した色を返すstatic簡易メソッド。
2. カラー・チューザ・ダイアログを生成するためのstatic簡易メソッド。カラー・チューザ・ダイアログでは、ユーザーがダイアログのボタンの1つを押したときに呼び出されるActionListenersを指定できる。
3. コンテナ内でJColorChooserペインのインスタンスを直接生成する機能。現在の「color」プロパティが変更されたときにそれを検出するためのPropertyChangeリスナーを追加できる。

警告: Swingはスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。1.4以降、すべてのJavaBeans(tm)用の長期間の格納サポートがjava.beansパッケージに追加されています。XMLEncoderを参照してください。

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
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 String	CHOOSER_PANELS_PROPERTY チューザ・パネル配列プロパティ名です。
static String	PREVIEW_PANEL_PROPERTY プレビュー・パネル・プロパティ名です。
static 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) 「OK」、「取消」、および「リセット」ボタンとともに指定されたColorChooserペインを含む新しいダイアログを作成して返します。
AccessibleContext	getAccessibleContext() このJColorChooserに関連付けられたAccessibleContextを取得します。
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() L&Fが変更されたことを示す、UIManagerからの通知です。

クラス 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

クラス 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, 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

クラス 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

チューザ・パネル配列プロパティ名です。

関連項目:

定数フィールド値

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」ボタンを押すと、このメソッドはダイアログを隠すかまたは破棄し、選択された色を返します。ユーザーが「Cancel」ボタンを押すか、あるいは「OK」を押さないでダイアログを閉じると、このメソッドはダイアログを隠すかまたは破棄し、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

「OK」、「取消」、および「リセット」ボタンとともに指定されたColorChooserペインを含む新しいダイアログを作成して返します。「OK」または「Cancel」ボタンが押されると、ダイアログは自動的に隠れます(破棄はされない)。「Reset」ボタンが押されると、カラー・チューザの色は、前回にダイアログでshowが呼び出されたときに設定された色にリセットされ、ダイアログはそのまま表示されます。

パラメータ:

c - ダイアログの親Component

title - ダイアログのタイトル

modal - boolean。trueの場合、ダイアログを閉じるまでプログラムの残りはアクティブでなくなる。

chooserPane - ダイアログ内に配置されるカラー・チューザ

okListener -「OK」が押されたときに呼び出されるActionListener

cancelListener -「Cancel」が押されたときに呼び出される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()

L&Fが変更されたことを示す、UIManagerからの通知です。現在のUIオブジェクトをUIManagerの最新バージョンに置き換えます。

オーバーライド:

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色に設定します。赤、緑、青の各値は0から255の範囲の数字でなければいけません。

パラメータ:

r - Redの量を指定する整数値

g - Greenの量を指定する整数値

b - Blueの量を指定する整数値

例外:

IllegalArgumentException - r、g、およびbの値が範囲外の場合

関連項目:

Color

setColor

public void setColor(int c)

カラー・チューザの現在の色を指定された色に設定します。

パラメータ:

c - チューザの現在の色を設定する整数値。下位8ビットはBlue値、次の8ビットはGreen値、上位8ビットはRed値を指定する。

setDragEnabled

public void setDragEnabled(boolean b)

dragEnabledプロパティを設定します。このプロパティは、このコンポーネントの自動ドラッグ処理(ドラッグ&ドロップの最初の処理)を有効にするためにtrueである必要があります。transferHandlerプロパティは、ドラッグでなんでもできるようにnull以外の値に設定する必要があります。dragEnabledプロパティのデフォルト値はfalseです。

自動ドラッグ処理が使用可能な場合、プレビュー・パネル上でマウスボタンを押すと、ほとんどのLook & Feelでドラッグ&ドロップ操作が開始されます。Look & Feelによっては、自動ドラッグ&ドロップ操作がサポートされていない場合があります。その場合、このプロパティは無視されます。TransferHandlerのexportAsDragメソッドを直接呼び出すようにコンポーネントを変更することにより、このようなLook & Feelを操作できます。

パラメータ:

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)

現在のプレビュー・パネルを設定します。このメソッドは、previewPanelという名前のプロパティに対してPropertyChangeEventをトリガーします。

パラメータ:

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

このJColorChooserに関連付けられたAccessibleContextを取得します。カラー・チューザの場合、AccessibleContextはAccessibleJColorChooserの形式を取ります。必要に応じて新規のAccessibleJColorChooserインスタンスが生成されます。

定義:

getAccessibleContext 、インタフェース: Accessible

オーバーライド:

getAccessibleContext、クラス: Component

戻り値:

このJColorChooserのAccessibleContextとして機能するAccessibleJColorChooser