javax.swing
クラス JColorChooser

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

public class JColorChooser

extends JComponent

implements Accessible

JColorChooser は、ユーザが色を操作および選択できるように設計されたコントロールの区画を提供します。 このクラスは、3 レベルの API を提供します。

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

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です

関連項目:

直列化された形式

内部クラスの概要

protected class

JColorChooser.AccessibleJColorChooser オブジェクトのユーザ補助機能のコンテキストを取得するために使用されるクラスです。

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

JComponent.AccessibleJComponent

フィールドの概要

protected AccessibleContext	accessibleContext
static String	CHOOSER_PANELS_PROPERTY チューザパネル配列プロパティ名です。
static String	PREVIEW_PANEL_PROPERTY プレビューパネルプロパティ名です。
static String	SELECTION_MODEL_PROPERTY 選択モデルプロパティ名です。

クラス javax.swing.JComponent から継承したフィールド

accessibleContext, 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

コンストラクタの概要

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」ボタンとともに、指定された JColorChooser 区画を持つ新しいダイアログボックスを作成し、それを返します。
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, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInsets, getInsets, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, isDoubleBuffered, isFocusCycleRoot, isFocusTraversable, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, processComponentKeyEvent, processFocusEvent, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setEnabled, setFont, setForeground, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, 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, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hide, 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, printAll, processComponentEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, 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 - ダイアログの親コンポーネント

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

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

createDialog

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

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

パラメータ:

c - ダイアログの親コンポーネント

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

modal - boolean 値。true の場合は、ダイアログが閉じるまでプログラムの他の部分は非アクティブになる

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

okListener - 「OK」が押されると呼び出されるアクションリスナー

cancelListener - 「Cancel」が押されると呼び出されるアクションリスナー

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 クラスの名前を返します。

戻り値:

"ColorChooserUI"

オーバーライド:

クラス JComponent 内の getUIClassID

関連項目:

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 色に設定します。

パラメータ:

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

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

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

setColor

public void setColor(int c)

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

パラメータ:

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

setPreviewPanel

public void setPreviewPanel(JComponent preview)

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

パラメータ:

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

関連項目:

JComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)

getPreviewPanel

public JComponent getPreviewPanel()

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

戻り値:

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

addChooserPanel

public void addChooserPanel(AbstractColorChooserPanel panel)

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

removeChooserPanel

public AbstractColorChooserPanel removeChooserPanel(AbstractColorChooserPanel panel)

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

パラメータ:

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

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

JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。

戻り値:

この JColorChooser の文字列表現

オーバーライド:

クラス JComponent 内の paramString

getAccessibleContext

public AccessibleContext getAccessibleContext()

JColorChooser に関連付けられている AccessibleContext を取得します。

定義:

インタフェース Accessible 内の getAccessibleContext

戻り値:

JColorChooser の AccessibleContext

オーバーライド:

クラス JComponent 内の getAccessibleContext