JColorChooser — 색상 선택기 컴포넌트

JColorChooser — 색상 선택기 컴포넌트

JColorChooser는 사용자가 색상을 조작하고 선택할 수 있도록 설계된 컨트롤 창을 제공하는 컴포넌트입니다.

출처: Java API Reference

본문

public class JColorChooser extends JComponent implements Accessible

JColorChooser는 사용자가 색상을 조작하고 선택할 수 있도록 설계된 컨트롤 창을 제공합니다. 색상 선택기 사용에 대한 정보는 The Java Tutorial의 "How to Use Color Choosers" 섹션을 참고하세요. 이 클래스는 세 가지 수준의 API를 제공합니다.

  • 모달 색상 선택기 대화상자를 표시하고 사용자가 선택한 색을 반환하는 정적 편의 메서드
  • 사용자가 대화상자 버튼 중 하나를 누를 때 호출될 ActionListener를 지정할 수 있는 색상 선택기 대화상자를 만드는 정적 편의 메서드
  • JColorChooser 창 인스턴스를 (어떤 컨테이너 안에서든) 직접 만들 수 있는 능력

PropertyChange 리스너를 추가해 현재 "color" 프로퍼티가 변경되는 시점을 감지할 수 있습니다. 경고: Swing은 스레드에 안전하지 않습니다. 이 클래스의 직렬화된 객체는 향후 Swing 버전과 호환되지 않을 수 있습니다. 현재 직렬화 지원은 단기 저장이나 같은 버전의 Swing을 실행하는 애플리케이션 간 RMI에 적합합니다. 1.4부터 모든 JavaBean의 장기 저장 지원이 java.beans 패키지에 추가되었으니 XMLEncoder를 참고하세요.

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

chooserPanel 배열 프로퍼티 이름입니다.

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 - 대화상자 제목을 담은 String
  • 매개변수: initialColor - 대화상자에 설정된 초기 색

createDialog

public static JDialog createDialog(Component c, String title, boolean modal, JColorChooser chooserPane, ActionListener okListener, ActionListener cancelListener) throws HeadlessException

색상 선택기 창을 지정된 제목과 리스너로 감싸는 새 대화상자를 만들고 반환합니다.

  • 매개변수: c - 대화상자의 부모 컴포넌트
  • 매개변수: title - 대화상자 제목
  • 매개변수: chooserPane - 대화상자 안에 놓을 색상 선택기 창

setColor

public void setColor(Color color)

현재 선택된 색을 설정합니다.

  • 매개변수: color - 새 색

getColor

public Color getColor()

현재 선택된 색을 가져옵니다.

  • 반환값: 현재 선택된 색

getSelectionModel

public ColorSelectionModel getSelectionModel()

현재 선택 모델을 반환합니다.

  • 반환값: 현재 ColorSelectionModel

setSelectionModel

@BeanProperty(description="The model which contains the currently selected color.") public void setSelectionModel(ColorSelectionModel newModel)

현재 선택 모델을 설정합니다.

  • 매개변수: newModel - 새 ColorSelectionModel

setPreviewPanel

@BeanProperty(description="The UI component which displays the currently selected color.") public void setPreviewPanel(JComponent preview)

미리 보기 패널을 설정합니다. 색을 변경하면 이 패널이 현재 선택된 색을 표시합니다.

  • 매개변수: preview - 새 미리 보기 패널

getPreviewPanel

public JComponent getPreviewPanel()

미리 보기 패널을 반환합니다.

  • 반환값: 현재 미리 보기 JComponent

더 알아보기