JavaTM 2 Platform
Standard Ed. 5.0

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)
カラーチューザの現在の色を指定された色に設定します。ColorSelectionModelChangeEvent をトリガします。

パラメータ:
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) では、コンポーネントを変更して TransferHandlerexportAsDrag メソッドを直接呼び出すことで、自動ドラッグ処理が可能になります。

パラメータ:
b - dragEnabled プロパティに設定される値
例外:
HeadlessException - btrue の場合で 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

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。