モジュール java.desktop

パッケージ javax.swing

クラスJColorChooser

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JColorChooser

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

ImageObserver, MenuContainer, Serializable, Accessible

@JavaBean(defaultProperty="UI", description="A component that supports selecting a Color.") 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の長期ストレージのサポートがjava.beansパッケージに追加されました。 XMLEncoderを参照してください。

導入されたバージョン:

1.2

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

ネストされたクラス

修飾子と型	クラス	説明
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 final String	CHOOSER_PANELS_PROPERTY	チューザ・パネル配列プロパティ名です。
static final String	PREVIEW_PANEL_PROPERTY	プレビュー・パネル・プロパティ名です。
static final 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(int c)	カラー・チューザの現在の色を指定された色に設定します。
void	setColor(int r, int g, int b)	カラー・チューザの現在の色を、指定されたRGB色に設定します。
void	setColor(Color color)	カラー・チューザの現在の色を指定された色に設定します。
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)	モーダルなカラー・チューザ・ダイアログを表示し、ダイアログが隠されるまでブロックします。
static Color	showDialog(Component component, String title, Color initialColor, boolean colorTransparencySelectionEnabled)	モーダルなカラー・チューザ・ダイアログを表示し、ダイアログが隠されるまでブロックします。
void	updateUI()	L&Fが変更されたことを示す、UIManagerからの通知です。

クラスjavax.swing.JComponentで宣言されたメソッド

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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, 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, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, 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()

showDialog

public static Color showDialog(Component component, String title, Color initialColor, boolean colorTransparencySelectionEnabled) throws HeadlessException

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

パラメータ:

component - ダイアログの親Component

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

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

colorTransparencySelectionEnabled - 色の透明度を選択できる場合はtrue

戻り値:

選択された色。ユーザーが中止した場合は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オブジェクトを返します。

オーバーライド:

クラスJComponentのgetUI

戻り値:

このコンポーネントをレンダリングするColorChooserUIオブジェクト

setUI

@BeanProperty(hidden=true, description="The UI object that implements the color chooser\'s LookAndFeel.") 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

@BeanProperty(bound=false) public String getUIClassID()

このコンポーネントをレンダリングするL&Fクラスの名前を返します。

オーバーライド:

getUIClassID、クラスJComponent

戻り値:

ColorChooserUIの文字列

関連項目:

• JComponent.getUIClassID()
• UIDefaults.getUI(javax.swing.JComponent)

getColor

public Color getColor()

カラー・チューザから現在の色値を取得します。 デフォルトでは、このメソッドは色値をモデルに委譲します。

戻り値:

カラー・チューザの現在の色値

setColor

@BeanProperty(bound=false, description="The current color the chooser is to display.") 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

@BeanProperty(bound=false, description="Determines whether automatic drag handling is enabled.") public void setDragEnabled(boolean b)

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

自動ドラッグ処理が使用可能な場合、プレビュー・パネル上でマウスボタンを押すと、ほとんどのルック・アンド・フィールでドラッグ・アンド・ドロップ操作が開始されます。 ルック・アンド・フィールによっては、自動ドラッグ・アンド・ドロップ操作がサポートされていない場合があります。その場合、このプロパティは無視されます。 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

@BeanProperty(hidden=true, description="The UI component which displays the current color.") 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

@BeanProperty(hidden=true, description="An array of different chooser types.") public void setChooserPanels(AbstractColorChooserPanel[] panels)

色値を選択するために使われるカラー・パネルを指定します。

パラメータ:

panels - AbstractColorChooserPanelオブジェクトの配列

getChooserPanels

public AbstractColorChooserPanel[] getChooserPanels()

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

戻り値:

AbstractColorChooserPanelオブジェクトの配列

getSelectionModel

public ColorSelectionModel getSelectionModel()

色の選択を扱うデータ・モデルを返します。

戻り値:

ColorSelectionModelオブジェクト

setSelectionModel

@BeanProperty(hidden=true, description="The model which contains the currently selected color.") public void setSelectionModel(ColorSelectionModel newModel)

選択された色を格納するモデルを設定します。

パラメータ:

newModel - 新しいColorSelectionModelオブジェクト

paramString

protected String paramString()

このJColorChooserの文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、nullにはできません。

オーバーライド:

paramString、クラスJComponent

戻り値:

このJColorChooserの文字列表現

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

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

定義:

getAccessibleContext、インタフェースAccessible

オーバーライド:

getAccessibleContext、クラスComponent

戻り値:

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