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를 참조하십시오.

중첩(Nested) 클래스 개요

protected class

JColorChooser.AccessibleJColorChooser 이 클래스는 JColorChooser 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.

클래스 javax.swing. JComponent 로부터 상속된 중첩(Nested) 클래스/인터페이스

JComponent.AccessibleJComponent

클래스 java.awt. Container 로부터 상속된 중첩(Nested) 클래스/인터페이스

Container.AccessibleAWTContainer

클래스 java.awt. Component 로부터 상속된 중첩(Nested) 클래스/인터페이스

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로 부터의 최신 버전에 옮겨놓습니다.

오버라이드(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()

컬러 츄-더로부터 현재의 색치를 취득합니다. 디폴트에서는 이 메서드는 색치를 모델에 위양 합니다.

반환값:

컬러 츄-더의 현재의 색치

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

현재의 프리뷰 패널을 설정합니다. 이 메서드는 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로는 되지 않습니다.

오버라이드(override):

클래스 JComponent 내의 paramString

반환값:

이 JColorChooser 캐릭터 라인 표현

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 JColorChooser에 관련된 AccessibleContext를 리턴합니다. 컬러 츄-더의 경우, AccessibleContext는 AccessibleJColorChooser 형식을 취합니다. 필요에 따라서 새로운의 AccessibleJColorChooser 인스턴스가 생성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 JComponent 내의 getAccessibleContext

반환값:

이 JColorChooser AccessibleContext 로서 기능하는 AccessibleJColorChooser