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 つを押したときに呼び出される ActionListener を指定できる
3. コンテナ内で JColorChooser 区画のインスタンスを直接生成する機能。現在の color プロパティが変更されたときにそれを検出するための PropertyChange リスナーを追加できる

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

入れ子のクラスの概要

protected class

JColorChooser.AccessibleJColorChooser このクラスは JColorChooser クラス用のユーザ補助機能のサポートを実装しています。

クラス javax.swing.JComponent から継承された入れ子のクラス/インタフェース

JComponent.AccessibleJComponent

クラス java.awt.Container から継承された入れ子のクラス/インタフェース

Container.AccessibleAWTContainer

クラス java.awt.Component から継承された入れ子のクラス/インタフェース

Component.AccessibleAWTComponent, 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]、[Cancel]、および [Reset] ボタンとともに、指定された 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 プロパティを設定します。
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, 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, 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, transferFocusBackward, 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, hide, 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, 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]、[Cancel]、および [Reset] ボタンとともに、指定された 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 からの最新バージョンに置き換えます。

オーバーライド:

クラス JComponent 内の updateUI

関連項目:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

このコンポーネントを描画する L&F クラスの名前を返します。

オーバーライド:

クラス JComponent 内の getUIClassID

戻り値:

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 (L&F) では、このプロパティは無視されます。このような Look & Feel (L&F) では、コンポーネントを変更して TransferHandler の exportAsDrag メソッドを直接呼び出すことで、自動ドラッグ処理が可能になります。

パラメータ:

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 にはなりません。

オーバーライド:

クラス JComponent 内の paramString

戻り値:

この JColorChooser の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス JComponent 内の getAccessibleContext

戻り値:

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