JCheckBoxMenuItem — 체크박스 메뉴 항목 컴포넌트

JCheckBoxMenuItem — 체크박스 메뉴 항목 컴포넌트

JCheckBoxMenuItem은 선택하거나 해제할 수 있는 메뉴 항목입니다. 선택되면 보통 옆에 체크 표시가 나타납니다.

출처: Java API Reference

본문

public class JCheckBoxMenuItem extends JMenuItem implements SwingConstants, Accessible

선택하거나 해제할 수 있는 메뉴 항목입니다. 선택되면 메뉴 항목은 보통 옆에 체크 표시가 있는 채로 나타나고, 해제되면 체크 표시 없이 나타납니다. 일반 메뉴 항목처럼 체크박스 메뉴 항목은 텍스트나 그래픽 아이콘과 연결되거나 둘 다 가질 수 있습니다. 메뉴 항목의 선택 상태를 결정·지정하려면 isSelected/setSelected 또는 getState/setState를 사용할 수 있습니다. 선호되는 메서드는 모든 메뉴와 버튼에서 동작하는 isSelected와 setSelected입니다. getState와 setState 메서드는 다른 컴포넌트 집합과의 호환을 위해 존재합니다. 메뉴 항목은 Action으로 구성하고 어느 정도 제어할 수 있습니다. 메뉴에서 여러 개의 체크박스 메뉴 항목을 선택해야 하는 경우가 있습니다. 이때 한 체크박스 메뉴 항목을 클릭해도 메뉴가 닫히지 않는 것이 유용합니다. 이런 동작은 클라이언트 JComponent.putClientProperty(java.lang.Object, java.lang.Object) 또는 룩앤필 UIManager.put(java.lang.Object, java.lang.Object)의 "CheckBoxMenuItem.doNotCloseOnMouseClick" 프로퍼티로 제어할 수 있습니다. 기본값은 false입니다. true로 설정하면 마우스로 클릭해도 메뉴가 닫히지 않습니다. 클라이언트 프로퍼티가 설정되면 그 값이 항상 사용되고, 그렇지 않으면 L&F 프로퍼티를 조회합니다. 참고: 일부 L&F는 이 프로퍼티를 무시할 수 있습니다. 내장된 모든 L&F는 이 동작을 상속합니다. 체크박스 메뉴 항목 사용에 대한 자세한 정보와 예는 The Java Tutorial의 "How to Use Menus" 섹션을 참고하세요. 경고: Swing은 스레드에 안전하지 않습니다. 이 클래스의 직렬화된 객체는 향후 Swing 버전과 호환되지 않을 수 있습니다. 현재 직렬화 지원은 단기 저장이나 같은 버전의 Swing을 실행하는 애플리케이션 간 RMI에 적합합니다. 1.4부터 모든 JavaBean의 장기 저장 지원이 java.beans 패키지에 추가되었으니 XMLEncoder를 참고하세요.

JCheckBoxMenuItem

public JCheckBoxMenuItem()

텍스트나 아이콘이 설정되지 않은, 처음에 선택되지 않은 체크박스 메뉴 항목을 만듭니다.

JCheckBoxMenuItem

public JCheckBoxMenuItem(Icon icon)

아이콘이 있는, 처음에 선택되지 않은 체크박스 메뉴 항목을 만듭니다.

  • 매개변수: icon - JCheckBoxMenuItem의 아이콘

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text)

텍스트가 있는, 처음에 선택되지 않은 체크박스 메뉴 항목을 만듭니다.

  • 매개변수: text - JCheckBoxMenuItem의 텍스트

JCheckBoxMenuItem

public JCheckBoxMenuItem(Action a)

속성이 제공된 Action에서 가져와지는 메뉴 항목을 만듭니다.

  • 매개변수: a - JCheckBoxMenuItem의 액션
  • 버전: 1.3

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text, Icon icon)

지정된 텍스트와 아이콘이 있는, 처음에 선택되지 않은 체크박스 메뉴 항목을 만듭니다.

  • 매개변수: text - JCheckBoxMenuItem의 텍스트
  • 매개변수: icon - JCheckBoxMenuItem의 아이콘

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text, boolean b)

지정된 텍스트와 선택 상태로 체크박스 메뉴 항목을 만듭니다.

  • 매개변수: text - 체크박스 메뉴 항목의 텍스트
  • 매개변수: b - 체크박스 메뉴 항목의 선택 상태

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text, Icon icon, boolean b)

지정된 텍스트, 아이콘, 선택 상태로 체크박스 메뉴 항목을 만듭니다.

  • 매개변수: text - 체크박스 메뉴 항목의 텍스트
  • 매개변수: icon - 체크박스 메뉴 항목의 아이콘
  • 매개변수: b - 체크박스 메뉴 항목의 선택 상태

getUIClassID

public String getUIClassID()

이 컴포넌트를 렌더링하는 L&F 클래스의 이름을 반환합니다.

  • 재정의: JMenuItem 클래스의 getUIClassID
  • 반환값: 문자열 "CheckBoxMenuItemUI"

getState

public boolean getState()

항목의 선택 상태를 반환합니다. 이 메서드는 AWT 호환용으로만 존재합니다. 새 코드는 isSelected()를 사용해야 합니다.

  • 반환값: 항목이 선택되었으면 true

setState

public void setState(boolean b)

항목의 선택 상태를 설정합니다. 이 메서드는 AWT 호환용으로만 존재합니다. 새 코드는 setSelected()를 사용해야 합니다.

  • 매개변수: b - 항목의 선택 상태를 나타내는 boolean, true=선택

getSelectedObjects

public Object[] getSelectedObjects()

체크박스 메뉴 항목 레이블을 담은 배열(길이 1)을 반환하거나, 체크박스가 선택되지 않았으면 null을 반환합니다.

  • 재정의: AbstractButton 클래스의 getSelectedObjects
  • 반환값: 항목이 선택되었으면 메뉴 항목의 텍스트인 한 Object를 담은 배열, 그렇지 않으면 null

paramString

protected String paramString()

이 JCheckBoxMenuItem의 문자열 표현을 반환합니다. 이 메서드는 디버깅 목적으로만 사용되며, 반환 문자열의 내용과 형식은 구현마다 다를 수 있습니다.

  • 재정의: JMenuItem 클래스의 paramString
  • 반환값: 이 JCheckBoxMenuItem의 문자열 표현

getAccessibleContext

public AccessibleContext getAccessibleContext()

이 JCheckBoxMenuItem과 연관된 AccessibleContext를 가져옵니다. JCheckBoxMenuItem의 경우 AccessibleContext는 AccessibleJCheckBoxMenuItem의 형태를 취합니다.

  • 반환값: 이 JCheckBoxMenuItem의 AccessibleContext 역할을 하는 AccessibleJCheckBoxMenuItem

더 알아보기