javax.swing
クラス JColorChooser

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.JColorChooser

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

Accessible, ImageObserver, MenuContainer, Serializable

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 に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:

直列化された形式

内部クラスの概要

protected class

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

クラス javax.swing.JComponent から継承した内部クラス

JComponent.AccessibleJComponent

クラス java.awt.Container から継承した内部クラス

Container.AccessibleAWTContainer

クラス java.awt.Component から継承した内部クラス

Component.AccessibleAWTComponent

フィールドの概要

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() カラーチューザから現在の色値を返します。
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	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, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVerifyInputWhenFocusTarget, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, hide, isDoubleBuffered, isFocusCycleRoot, isFocusTraversable, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processFocusEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

クラス java.awt.Container から継承したメソッド

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree

クラス java.awt.Component から継承したメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, imageUpdate, inside, isDisplayable, isEnabled, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus

クラス 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 でカラーチューザの区画を作成します。

パラメータ:

initialColor - チューザの初期色のセット

メソッドの詳細

showDialog

public static Color showDialog(Component component,
                               String title,
                               Color initialColor)

モーダルなカラーチューザダイアログを表示し、ダイアログが隠されるまでブロックします。ユーザが [OK] ボタンを押すと、このメソッドはダイアログを隠すかまたは破棄し、選択された色を返します。ユーザが [Cancel] ボタンを押すか、あるいは [OK] を押さないでダイアログを閉じると、このメソッドはダイアログを隠すかまたは破棄し、null を返します。

パラメータ:

component - ダイアログの親 Component

title - ダイアログのタイトルを含む文字列

initialColor - カラーチューザが表示されるときの初期色のセット

createDialog

public static JDialog createDialog(Component c,
                                   String title,
                                   boolean modal,
                                   JColorChooser chooserPane,
                                   ActionListener okListener,
                                   ActionListener cancelListener)

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

パラメータ:

c - ダイアログの親 Component

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

modal - boolean 値。true の場合は、ダイアログが閉じるまでプログラムの他の部分は停止する

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

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

cancelListener - [Cancel] が押されたときに呼び出される ActionListener

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)

カラーチューザの現在の色を指定された色に設定します。このメソッドは、color プロパティに対して PropertyChangeEvent をトリガーします。

パラメータ:

color - カラーチューザに設定される色

関連項目:

JComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)

setColor

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

カラーチューザの現在の色を、指定された RGB 色に設定します。赤、緑、青の各値は 0 〜 255 の範囲の数字でなければなりません。

パラメータ:

r - Red の量を指定する int 値

g - Green の量を指定する int 値

b - Blue の量を指定する int 値

例外:

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

関連項目:

Color

setColor

public void setColor(int c)

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

パラメータ:

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

setPreviewPanel

public void setPreviewPanel(JComponent preview)

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

パラメータ:

color - カラーチューザに設定される色

関連項目:

JComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)

getPreviewPanel

public JComponent getPreviewPanel()

選択された色を表示するプレビューパネルを返します。

戻り値:

JComponent オブジェクト -- プレビューパネル

addChooserPanel

public void addChooserPanel(AbstractColorChooserPanel panel)

カラーチューザにカラーチューザパネルを追加します。

removeChooserPanel

public AbstractColorChooserPanel removeChooserPanel(AbstractColorChooserPanel panel)

指定されたカラーパネルを削除します。

パラメータ:

name - 削除するパネルを指定する文字列

戻り値:

カラーパネル

例外:

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