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 는 thread에 대해서 안전하지는 않습니다. 자세한 것은,「Swing's Threading Policy」를 참조해 주세요.

경고: 이 클래스의 직렬화 된 객체는, 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 지원는, 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK Version 1.4 이후, 모든 JavaBeans^™ 의 장기간의 운용 지원는,java.beans 패키지에 추가되고 있습니다. 자세한 것은,XMLEncoder 를 참조해 주세요.

상자의 클래스의 개요

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 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 () 이 컴퍼넌트를 draw 하는 L&F 객체를 돌려줍니다.
String	getUIClassID () 이 컴퍼넌트를 draw 하는 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) 이 컴퍼넌트를 draw 하는 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 , 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 , isDoubleBuffered , isLightweightComponent , isManagingFocus , isOpaque , isOptimizedDrawingEnabled , isPaintingForPrint , 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()

이 컴퍼넌트를 draw 하는 L&F 객체를 돌려줍니다.

반환값:

이 컴퍼넌트를 draw 하는 ColorChooserUI 객체

setUI

public void setUI(ColorChooserUI  ui)

이 컴퍼넌트를 draw 하는 L&F 객체를 설정합니다.

파라미터:

ui - ColorChooserUI 의 L&F 객체

관련 항목:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

L&F 가 변경되었다고 하는 UIManager 로부터의 통지입니다. 현재의 UI 객체를 UIManager 의 최신 버젼에 옮겨놓습니다.

오버라이드(override):

클래스 JComponent 내의 updateUI

관련 항목:

JComponent.updateUI()

getUIClassID

public String  getUIClassID()

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

오버라이드(override):

클래스 JComponent 내의 getUIClassID

반환값:

ColorChooserUI 의 캐릭터 라인

관련 항목:

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

getColor

public Color  getColor()

칼라 츄-더로부터 현재의 색치를 가져옵니다. 디폴트에서는, 이 메소드는 색치를 모델에 위양 합니다.

반환값:

칼라 츄-더의 현재의 색치

setColor

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

public void setDragEnabled(boolean b)

dragEnabled 프로퍼티을 설정합니다. 이 프로퍼티은, 이 컴퍼넌트의 자동 드래그 처리 (드래그＆드롭의 최초의 처리)를 유효하게 하기 위해서 true 가 아니면 안됩니다. transferHandler 프로퍼티은, 드래그로 뭐든지 할 수 있도록(듯이) null 이외의 값으로 설정할 필요가 있습니다. dragEnabled 프로퍼티의 디폴트의 값은 false 입니다.

자동 드래그 처리가 사용 가능한 경우, 프리뷰 패널상에서 mouse button를 누르면(자), 대부분의 Look & Feel (L&F)로 드래그＆드롭 조작이 개시됩니다. 일부의 Look & Feel 는 자동 드래그＆드롭 조작을 지원하지 않는 경우가 있습니다. 이것들은 이 프로퍼티을 무시합니다. 직접 TransferHandler 의 exportAsDrag 메소드를 호출해 컴퍼넌트를 변경하는 것으로써, 이러한 Look & Feel 를 조작할 수가 있습니다.

파라미터:

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)

현재의 프리뷰 패널을 설정합니다. 이 메소드는, 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 의 캐릭터 라인 표현을 돌려줍니다. 이 메소드는 디버그 전용이며, 반환되는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 반환되는 캐릭터 라인은 빈 상태(empty)의 경우가 있습니다만,null 로는 되지 않습니다.

오버라이드(override):

클래스 JComponent 내의 paramString

반환값:

이 JColorChooser 의 캐릭터 라인 표현

getAccessibleContext

public AccessibleContext  getAccessibleContext()

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

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 JComponent 내의 getAccessibleContext

반환값:

이 JColorChooser 의 AccessibleContext 로서 기능하는 AccessibleJColorChooser