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 (L&F) でドラッグ&ドロップ操作が開始されます。一部の 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 、クラス: JComponent

戻り値:

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