public class JColorChooser extends JComponent implements Accessible
JColorChooserは、ユーザーが色を操作したり、選択したりできるように設計されたコントロールのペインを提供します。 カラー・チューザの使用については、『The Java Tutorial』の「How to Use Color Choosers」を参照してください。
このクラスは3つのレベルのAPIを提供します。
ActionListenersを指定できる。
JColorChooserペインのインスタンスを直接生成する機能。 現在の「color」プロパティが変更されたときにそれを検出するためのPropertyChangeリスナーを追加できる。
警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4以降、すべてのJavaBeans™用の長期間の格納サポートがjava.beansパッケージに追加されています。 XMLEncoderを参照してください。
| 修飾子と型 | クラス | 説明 |
|---|---|---|
protected class |
JColorChooser.AccessibleJColorChooser |
このクラスは
JColorChooserクラスのアクセシビリティ・サポートを実装しています。 |
JComponent.AccessibleJComponentContainer.AccessibleAWTContainerComponent.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy| 修飾子と型 | フィールド | 説明 |
|---|---|---|
protected AccessibleContext |
accessibleContext |
|
static String |
CHOOSER_PANELS_PROPERTY |
チューザ・パネル配列プロパティ名です。
|
static String |
PREVIEW_PANEL_PROPERTY |
プレビュー・パネル・プロパティ名です。
|
static String |
SELECTION_MODEL_PROPERTY |
選択モデル・プロパティ名です。
|
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOWBOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, 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(Color color) |
カラー・チューザの現在の色を指定された色に設定します。
|
void |
setColor(int c) |
カラー・チューザの現在の色を指定された色に設定します。
|
void |
setColor(int r, int g, int b) |
カラー・チューザの現在の色を、指定されたRGB色に設定します。
|
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) |
モーダルなカラー・チューザ・ダイアログを表示し、ダイアログが隠されるまでブロックします。
|
void |
updateUI() |
L&Fが変更されたことを示す、
UIManagerからの通知です。 |
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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, updateadd, 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, validateTreeaction, 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, 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, transferFocusBackward, transferFocusUpCyclepublic static final String SELECTION_MODEL_PROPERTY
public static final String PREVIEW_PANEL_PROPERTY
public static final String CHOOSER_PANELS_PROPERTY
protected AccessibleContext accessibleContext
public JColorChooser()
public JColorChooser(Color initialColor)
initialColor - チューザの初期色のセットpublic JColorChooser(ColorSelectionModel model)
ColorSelectionModelでカラー・チューザのペインを生成します。model - 使用されるColorSelectionModelpublic static Color showDialog(Component component, String title, Color initialColor) throws HeadlessException
nullを返します。 component - ダイアログの親Componenttitle - ダイアログのタイトルを含む文字列initialColor - カラー・チューザが表示されるときの初期色のセットnullHeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。GraphicsEnvironment.isHeadless()public static JDialog createDialog(Component c, String title, boolean modal, JColorChooser chooserPane, ActionListener okListener, ActionListener cancelListener) throws HeadlessException
ColorChooserペインを含む新しいダイアログを作成して返します。 「OK」または「Cancel」ボタンが押されると、ダイアログは自動的に隠れます(破棄はされない)。 「Reset」ボタンが押されると、カラー・チューザの色は、前回にダイアログでshowが呼び出されたときに設定された色にリセットされ、ダイアログはそのまま表示されます。 c - ダイアログの親Componenttitle - ダイアログのタイトルmodal - boolean。 trueの場合、ダイアログを閉じるまでプログラムの残りはアクティブでなくなる。 chooserPane - ダイアログ内に配置されるカラー・チューザokListener -「OK」が押されたときに呼び出されるActionListenercancelListener -「Cancel」が押されたときに呼び出されるActionListenerHeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。GraphicsEnvironment.isHeadless()public ColorChooserUI getUI()
ColorChooserUIオブジェクトpublic void setUI(ColorChooserUI ui)
ui - ColorChooserUI L&FオブジェクトUIDefaults.getUI(javax.swing.JComponent)public void updateUI()
UIManagerからの通知です。 現在のUIオブジェクトをUIManagerの最新バージョンに置き換えます。 updateUI、クラスJComponentJComponent.updateUI()public String getUIClassID()
getUIClassID、クラスJComponentJComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)public Color getColor()
public void setColor(Color color)
ColorSelectionModelはChangeEventをトリガーします。 color - カラー・チューザに設定される色Container.addPropertyChangeListener(java.beans.PropertyChangeListener)public void setColor(int r,
int g,
int b)
r - Redの量を指定する整数値g - Greenの量を指定する整数値b - Blueの量を指定する整数値IllegalArgumentException - r、g、およびbの値が範囲外の場合Colorpublic void setColor(int c)
c - チューザの現在の色を設定する整数値。下位8ビットはBlue値、次の8ビットはGreen値、上位8ビットはRed値を指定する。public void setDragEnabled(boolean b)
dragEnabledプロパティを設定します。このプロパティは、このコンポーネントの自動ドラッグ処理(ドラッグ・アンド・ドロップの最初の処理)を有効にするためにtrueである必要があります。 transferHandlerプロパティは、ドラッグでなんでもできるようにnull以外の値に設定する必要があります。 dragEnabledプロパティのデフォルト値はfalseです。
自動ドラッグ処理が使用可能な場合、プレビュー・パネル上でマウスボタンを押すと、ほとんどのルック・アンド・フィールでドラッグ・アンド・ドロップ操作が開始されます。 ルック・アンド・フィールによっては、自動ドラッグ・アンド・ドロップ操作がサポートされていない場合があります。その場合、このプロパティは無視されます。 TransferHandlerのexportAsDragメソッドを直接呼び出すようにコンポーネントを変更することにより、このようなルック・アンド・フィールを操作できます。
b - dragEnabledプロパティに設定される値HeadlessException - bがtrueで、GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless(), getDragEnabled(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandlerpublic boolean getDragEnabled()
dragEnabledプロパティの値を取得します。dragEnabledプロパティの値setDragEnabled(boolean)public void setPreviewPanel(JComponent preview)
PropertyChangeEventをトリガーします。 preview - 現在の色を表示するJComponentContainer.addPropertyChangeListener(java.beans.PropertyChangeListener)public JComponent getPreviewPanel()
JComponentオブジェクト -- プレビュー・パネルpublic void addChooserPanel(AbstractColorChooserPanel panel)
panel - 追加されるAbstractColorChooserPanelpublic AbstractColorChooserPanel removeChooserPanel(AbstractColorChooserPanel panel)
panel - 削除するパネルを指定する文字列IllegalArgumentException - パネルが既知のチューザ・パネルのリストにない場合public void setChooserPanels(AbstractColorChooserPanel[] panels)
panels - AbstractColorChooserPanelオブジェクトの配列public AbstractColorChooserPanel[] getChooserPanels()
AbstractColorChooserPanelオブジェクトの配列public ColorSelectionModel getSelectionModel()
ColorSelectionModelオブジェクトpublic void setSelectionModel(ColorSelectionModel newModel)
newModel - 新しいColorSelectionModelオブジェクトprotected String paramString()
JColorChooserの文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。 返される文字列は空の場合がありますが、nullにはなりません。 paramString、クラスJComponentJColorChooserの文字列表現public AccessibleContext getAccessibleContext()
getAccessibleContext、インタフェースAccessiblegetAccessibleContext、クラスComponent バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。