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 에 적절하고 있습니다. 1.4 로부터는 모든 JavaBeans^TM 의 장기간의 보관이 java.beans 패키지로 추가 서포트되고 있습니다. {@link java.beans.XMLEncoder)를 참조해 주세요.

중첩된 클래스의 개요

protected class

JColorChooser.AccessibleJColorChooser 이 클래스는 JColorChooser 클래스용의 유저 보조 기능의 서포트를 구현하고 있습니다.

클래스 javax.swing. JComponent 을 상속받은 중첩된 클래스

클래스 java.awt. Container 을 상속받은 중첩된 클래스

클래스 java.awt. Component 을 상속받은 중첩된 클래스

Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

protected AccessibleContext	accessibleContext
static String	CHOOSER_PANELS_PROPERTY 츄-더 패널 배열 프로퍼티명입니다.
static String	PREVIEW_PANEL_PROPERTY preview 패널 프로퍼티명입니다.
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 () 선택된 색을 표시하는 preview 패널을 돌려줍니다.
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) 현재의 preview 패널을 설정합니다.
void	setSelectionModel (ColorSelectionModel newModel) 선택된 색을 저장하는 모델을 설정합니다.
void	setUI (ColorChooserUI ui) 이 컴퍼넌트를 표현 하는 L&F 오브젝트를 설정합니다.
static Color	showDialog (Component component, String title, Color initialColor) 모덜인 칼라 츄-더 다이얼로그를 표시해, 다이얼로그가 숨겨질 때까지 블록 합니다.
void	updateUI () UIManager 로부터의 L&F 변경을 나타내는 통지입니다.

클래스 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 , getAncestorListeners , getAutoscrolls , getBorder , getBounds , getClientProperty , getComponentGraphics , getConditionForKeyStroke , getDebugGraphicsOptions , getDefaultLocale , getGraphics , getHeight , getInputMap , getInputMap , getInputVerifier , getInsets , getInsets , getListeners , getLocation , getMaximumSize , getMinimumSize , getNextFocusableComponent , getPreferredSize , getPropertyChangeListeners , getPropertyChangeListeners , getRegisteredKeyStrokes , getRootPane , getSize , getToolTipLocation , getToolTipText , getToolTipText , getTopLevelAncestor , getTransferHandler , getVerifyInputWhenFocusTarget , getVetoableChangeListeners , getVisibleRect , getWidth , getX , getY , grabFocus , isDoubleBuffered , isLightweightComponent , isManagingFocus , isMaximumSizeSet , isMinimumSizeSet , isOpaque , isOptimizedDrawingEnabled , isPaintingTile , isPreferredSizeSet , isRequestFocusEnabled , isValidateRoot , paint , paintBorder , paintChildren , paintComponent , paintImmediately , paintImmediately , print , printAll , printBorder , printChildren , printComponent , processComponentKeyEvent , processKeyBinding , processKeyEvent , processMouseMotionEvent , putClientProperty , registerKeyboardAction , registerKeyboardAction , removeAncestorListener , removeNotify , removePropertyChangeListener , removePropertyChangeListener , removeVetoableChangeListener , repaint , repaint , requestDefaultFocus , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , resetKeyboardActions , reshape , revalidate , scrollRectToVisible , setActionMap , setAlignmentX , setAlignmentY , setAutoscrolls , setBackground , setBorder , setDebugGraphicsOptions , setDefaultLocale , setDoubleBuffered , setEnabled , setFont , setForeground , 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 , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getLayout , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , preferredSize , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setFocusCycleRoot , setFocusTraversalKeys , setFocusTraversalPolicy , 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 , getBackground , getBounds , getColorModel , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphicsConfiguration , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocale , getLocation , getLocationOnScreen , getMouseListeners , getMouseMotionListeners , getMouseWheelListeners , getName , getParent , getPeer , getSize , getToolkit , getTreeLock , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , isBackgroundSet , isCursorSet , isDisplayable , isEnabled , isFocusable , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , 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 , processMouseEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , 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

preview 패널 프로퍼티명입니다.

관련 항목:

정수 필드치

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 로 칼라 츄-더의 구획을 생성합니다.

메소드의 상세

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()

UIManager 로부터의 L&F 변경을 나타내는 통지입니다. 현재의 UI 오브젝트를 UIManager 로부터의 최신 버젼에 옮겨놓습니다.

오버라이드(override):

클래스 JComponent 내의 updateUI

관련 항목:

JComponent.updateUI()

getUIClassID

public String  getUIClassID()

이 컴퍼넌트를 표현 하는 L&F 클래스의 이름을 돌려줍니다.

오버라이드(override):

클래스 JComponent 내의 getUIClassID

반환값:

ColorChooserUI 의 캐릭터 라인

관련 항목:

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

getColor

public Color  getColor()

칼라 츄-더로부터 현재의 색치를 취득합니다. 디폴트에서는 이 메소드는 색치를 모델에 delegate 합니다.

반환값:

칼라 츄-더의 현재의 색치

setColor

public void setColor(Color  color)

칼라 츄-더의 현재의 색이 지정된 색으로 설정합니다. ColorSelectionModel 는 ChangeEvent 를 방아쇠 합니다.

파라미터:

color - 칼라 츄-더로 설정되는 색

관련 항목:

JComponent.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 입니다.

자동 드러그 처리가 사용 가능한 경우, preview 패널상에서 mouse button를 누르면(자), 대부분의 Look & Feel (L&F)로 드러그＆드롭 조작이 개시됩니다. 자동 드러그＆드롭을 서포트하지 않는 Look & Feel (L&F)에서는 이 프로퍼티는 무시됩니다. 이러한 Look & Feel (L&F)에서는 컴퍼넌트를 변경해 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

public void setPreviewPanel(JComponent  preview)

현재의 preview 패널을 설정합니다. 이 메소드는 previewPanel 라는 이름의 프로퍼티에 대해서 PropertyChangeEvent 를 방아쇠 합니다.

관련 항목:

JComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)

getPreviewPanel

public JComponent  getPreviewPanel()

선택된 색을 표시하는 preview 패널을 돌려줍니다.

반환값:

JComponent 오브젝트 -- preview 패널

addChooserPanel

public void addChooserPanel(AbstractColorChooserPanel  panel)

칼라 츄-더에 칼라 츄-더 패널을 추가합니다.

파라미터:

panel - 추가하는 AbstractColorChooserPanel

removeChooserPanel

public AbstractColorChooserPanel  removeChooserPanel(AbstractColorChooserPanel  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 로는 되지 않습니다.

오버라이드(override):

클래스 JComponent 내의 paramString

반환값:

이 JColorChooser 의 캐릭터 라인 표현

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 JColorChooser 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다. 칼라 츄-더의 경우, AccessibleContext 는 AccessibleJColorChooser 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleJColorChooser 인스턴스가 생성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 JComponent 내의 getAccessibleContext

반환값:

이 JColorChooser 의 AccessibleContext 로서 기능하는 AccessibleJColorChooser