java.awt
클래스 CheckboxMenuItem

java.lang.Object 
  |
  +--java.awt.MenuComponent 
        |
        +--java.awt.MenuItem 
              |
              +--java.awt.CheckboxMenuItem

모든 구현 인터페이스:

Accessible , ItemSelectable , Serializable

public class CheckboxMenuItem

extends MenuItem

implements ItemSelectable , Accessible

이 클래스는 메뉴에 추가할 수 있는 체크 박스를 나타냅니다. 메뉴내의 체크 박스를 선택하면(자), 그 상태가 「온」으로부터 「오프」에, 또는 「오프」로부터 「온」에 변경됩니다.

다음의 그림은 CheckBoxMenuItem 의 인스턴스가 포함되어 있는 메뉴를 나타냅니다.

Check 라고 하는 label가 붙은 항목은 「오프」 상태의 체크 박스 메뉴 항목을 나타냅니다.

체크 박스 메뉴 항목을 선택하면(자), AWT 는 항목 이벤트를 그 항목에 보냅니다. 이 이벤트는 ItemEvent 의 인스턴스이므로,processEvent 메소드는 그 이벤트를 조사해 processItemEvent 에 건네줍니다. 후자의 메소드는 이 메뉴 항목에 의해 생성되는 항목 이벤트의 통지를 등록하고 있는 모든 ItemListener 오브젝트에 그 이벤트를 보냅니다.

도입된 버젼:

JDK1. 0

관련 항목:

ItemEvent , ItemListener , 직렬화 된 형식

중첩된 클래스의 개요

protected class

CheckboxMenuItem.AccessibleAWTCheckboxMenuItem 유저 보조 기능의 디폴트 서포트를 제공하는데 사용되는 CheckboxMenultem 의 내부 클래스입니다.

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

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

생성자의 개요

CheckboxMenuItem ()
하늘의 label가 붙은 체크 박스 메뉴 항목을 생성합니다.

CheckboxMenuItem (String label)
지정된 label가 붙은 체크 박스 메뉴 항목을 생성합니다.

CheckboxMenuItem (String label, boolean state)
지정된 label가 붙은 체크 박스 메뉴 항목을, 지정된 상태로 생성합니다.

메소드의 개요

void	addItemListener (ItemListener l) 지정된 항목 청취자를, 이 체크 박스의 항목 이벤트 수신을 위해서(때문에) 추가합니다.
void	addNotify () 체크 박스 항목의 피어를 생성합니다.
AccessibleContext	getAccessibleContext () 이 CheckboxMenuItem 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다.
ItemListener []	getItemListeners () 이 체크 박스 메뉴 항목에 등록되어 모든 항목 청취자의 배열을 돌려줍니다.
EventListener []	getListeners (Class listenerType) 이 CheckboxMenuItem 에 FooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다.
Object []	getSelectedObjects () 체크 박스 메뉴 항목의 label를 포함한 배열 (길이 1)을 돌려줍니다.
boolean	getState () 이 체크 박스 메뉴 항목 상태가 「온」일까 「오프」인지를 판정합니다.
String	paramString () 이 CheckBoxMenuItem 상태를 나타내는 캐릭터 라인을 돌려줍니다.
protected void	processEvent (AWTEvent e) 이 체크 박스 메뉴 항목의 이벤트를 처리합니다.
protected void	processItemEvent (ItemEvent e) 이 체크 박스 메뉴 항목으로 발생하는 항목 이벤트를, 등록되어 있는 ItemListener 오브젝트에 디스팟치 하는 것으로써, 항목 이벤트를 처리합니다.
void	removeItemListener (ItemListener l) 이 체크 박스 메뉴 항목으로부터의 항목 이벤트를 받지 않게, 지정된 항목 청취자를 삭제합니다.
void	setState (boolean b) 이 체크 박스 메뉴 항목을, 지정된 상태로 설정합니다.

클래스 java.awt. MenuItem 에서 상속받은 메소드

addActionListener , deleteShortcut , disable , disableEvents , enable , enable , enableEvents , getActionCommand , getActionListeners , getLabel , getShortcut , isEnabled , processActionEvent , removeActionListener , setActionCommand , setEnabled , setLabel , setShortcut

클래스 java.awt. MenuComponent 에서 상속받은 메소드

dispatchEvent , getFont , getName , getParent , getPeer , getTreeLock , postEvent , removeNotify , setFont , setName , toString

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

생성자의 상세

CheckboxMenuItem

public CheckboxMenuItem()
                 throws HeadlessException 

하늘의 label가 붙은 체크 박스 메뉴 항목을 생성합니다. 항목의 초기 상태는 「오프」로 설정됩니다.

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

도입된 버젼:

JDK1. 1

관련 항목:

GraphicsEnvironment.isHeadless()

CheckboxMenuItem

public CheckboxMenuItem(String  label)
                 throws HeadlessException 

지정된 label가 붙은 체크 박스 메뉴 항목을 생성합니다. 항목의 초기 상태는 「오프」로 설정됩니다.

파라미터:

label - 체크 박스 메뉴 항목의 캐릭터 라인 label. 메뉴 항목에 label가 없는 경우는 null

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

CheckboxMenuItem

public CheckboxMenuItem(String  label,
                        boolean state)
                 throws HeadlessException 

지정된 label가 붙은 체크 박스 메뉴 항목을, 지정된 상태로 생성합니다.

파라미터:

label - 체크 박스 메뉴 항목의 캐릭터 라인 label. 메뉴 항목에 label가 없는 경우는 null

state - 메뉴 항목의 초기 상태. true 는 「온」을,false 는 「오프」를 나타낸다

예외:

HeadlessException - GraphicsEnvironment.isHeadless()이 true 를 돌려주는 경우

도입된 버젼:

JDK1. 1

관련 항목:

GraphicsEnvironment.isHeadless()

메소드의 상세

addNotify

public void addNotify()

체크 박스 항목의 피어를 생성합니다. 이것에 의해, 체크 박스 항목의 기능을 변경하는 일 없이, 그 외관을 변경하는 것이 가능하게 됩니다. 대부분의 어플리케이션은 이 메소드를 직접 호출할 것은 없습니다.

오버라이드(override):

클래스 MenuItem 내의 addNotify

관련 항목:

Toolkit.createCheckboxMenuItem(java.awt.CheckboxMenuItem) , Component.getToolkit()

getState

public boolean getState()

이 체크 박스 메뉴 항목 상태가 「온」일까 「오프」인지를 판정합니다.

반환값:

이 체크 박스 메뉴 항목 상태. true 는 「온」을,false 는 「오프」를 나타내는

관련 항목:

setState(boolean)

setState

public void setState(boolean b)

이 체크 박스 메뉴 항목을, 지정된 상태로 설정합니다. boolean 치 true 는 「온」을 나타내,false 는 「오프」를 나타냅니다.

이 메소드는 주로 체크 박스 메뉴 항목의 스테이터스 초기화를 위해서(때문에) 사용해 주세요. 체크 박스의 스테이터스를 프로그램으로 설정해도 ItemEvent 는 개시되지 않습니다. ItemEvent 를 개시하는 유일한 방법은 유저의 조작 뿐입니다.

파라미터:

b - 체크 박스 메뉴 아이템이 「온」의 경우는 true, 그렇지 않은 경우는 false

관련 항목:

getState()

getSelectedObjects

public Object [] getSelectedObjects()

체크 박스 메뉴 항목의 label를 포함한 배열 (길이 1)을 돌려줍니다. 다만, 체크 박스가 선택되어 있지 않은 경우에는 null 를 돌려줍니다.

정의:

인터페이스 ItemSelectable 내의 getSelectedObjects

관련 항목:

ItemSelectable

addItemListener

public void addItemListener(ItemListener  l)

지정된 항목 청취자를, 이 체크 박스의 항목 이벤트 수신을 위해서(때문에) 추가합니다. 항목 이벤트는 setState()의 호출은 아니고, 유저의 액션에 반응해 청취자에게 송신됩니다. l 가 null 의 경우, 예외는 슬로우 되지 않고 처리도 실행되지 않습니다.

정의:

인터페이스 ItemSelectable 내의 addItemListener

파라미터:

l - 항목 청취자

도입된 버젼:

JDK1. 1

관련 항목:

removeItemListener(java.awt.event.ItemListener) , getItemListeners() , setState(boolean) , ItemEvent , ItemListener

removeItemListener

public void removeItemListener(ItemListener  l)

이 체크 박스 메뉴 항목으로부터의 항목 이벤트를 받지 않게, 지정된 항목 청취자를 삭제합니다. l 가 null 의 경우, 예외는 슬로우 되지 않고 처리도 실행되지 않습니다.

정의:

인터페이스 ItemSelectable 내의 removeItemListener

파라미터:

l - 항목 청취자

도입된 버젼:

JDK1. 1

관련 항목:

addItemListener(java.awt.event.ItemListener) , getItemListeners() , ItemEvent , ItemListener

getItemListeners

public ItemListener [] getItemListeners()

이 체크 박스 메뉴 항목에 등록되어 모든 항목 청취자의 배열을 돌려줍니다.

반환값:

이 체크 박스 메뉴 항목의 모든 ItemListener. 항목 청취자가 현재 등록되지 않은 경우는 하늘의 배열을 돌려주는

도입된 버젼:

1.4

관련 항목:

addItemListener(java.awt.event.ItemListener) , removeItemListener(java.awt.event.ItemListener) , ItemEvent , ItemListener

getListeners

public EventListener [] getListeners(Class  listenerType)

이 CheckboxMenuItem 에 FooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다. 이 FooListener 는 addFooListener 메소드로 등록된 것입니다.

listenerType 인수는 FooListener.class 와 같은 클래스 리터럴로 지정할 수 있습니다. 예를 들어, 이 항목 청취자에 대한 CheckboxMenuItem c 의 조회는 다음의 코드로 실시합니다.

ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));

이러한 청취자가 없는 경우는 하늘의 배열을 돌려줍니다.

오버라이드(override):

클래스 MenuItem 내의 getListeners

파라미터:

listenerType - 요구되는 청취자의 타입. java.util.EventListener 의 하위 인터페이스를 지정

반환값:

이 체크 박스 메뉴 항목에 FooListener 로서 등록되어 모든 오브젝트의 배열. 청취자가 등록되지 않은 경우는 하늘의 배열을 돌려준다

예외:

ClassCastException - listenerType 가 java.util.EventListener 를 구현하는 클래스 또는 인터페이스를 지정하지 않는 경우

도입된 버젼:

1.3

관련 항목:

getItemListeners()

processEvent

protected void processEvent(AWTEvent  e)

이 체크 박스 메뉴 항목의 이벤트를 처리합니다. 이벤트가 ItemEvent 의 인스턴스인 경우, 이 메소드는 processItemEvent 메소드를 호출합니다. 이벤트가 항목 이벤트가 아닌 경우, 슈퍼 클래스의 processEvent 를 호출합니다.

현재, 체크 박스 메뉴 항목이 서포트하고 있는 것은 항목 이벤트 뿐입니다.

이벤트 파라미터가 null 의 경우의 동작은 정의되어 있지 않기 때문에 예외가 슬로우 됩니다.

오버라이드(override):

클래스 MenuItem 내의 processEvent

파라미터:

e - 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

ItemEvent , processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent  e)

이 체크 박스 메뉴 항목으로 발생하는 항목 이벤트를, 등록되어 있는 ItemListener 오브젝트에 디스팟치 하는 것으로써, 항목 이벤트를 처리합니다.

이 메뉴 항목으로 항목 이벤트가 사용 가능하지 않은 경우, 이 메소드는 불려 가지 않습니다. 항목 이벤트는 다음의 어떤 것인가의 경우에 사용 가능하게 됩니다.

• ItemListener 오브젝트가 addItemListener 를 사용해 등록된다
• enableEvents 에 의해 항목 이벤트가 사용 가능하게 되어 있다

이벤트 파라미터가 null 의 경우의 동작은 정의되어 있지 않기 때문에 예외가 슬로우 됩니다.

파라미터:

e - 항목 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

ItemEvent , ItemListener , addItemListener(java.awt.event.ItemListener) , MenuItem.enableEvents(long)

paramString

public String  paramString()

이 CheckBoxMenuItem 상태를 나타내는 캐릭터 라인을 돌려줍니다. 이 메소드는 디버그 전용이며, 돌려주어지는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 돌려주어지는 캐릭터 라인은 공백의 경우가 있습니다만,null 로는 되지 않습니다.

오버라이드(override):

클래스 MenuItem 내의 paramString

반환값:

이 체크 박스 메뉴 항목의 파라미터 캐릭터 라인

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 CheckboxMenuItem 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다. CheckboxMenuItem 의 경우, AccessibleContext 은 AccessibleAWTCheckboxMenuItem 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleAWTCheckboxMenuItem 가 생성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 MenuItem 내의 getAccessibleContext

반환값:

이 CheckboxMenuItem 의 AccessibleContext 으로서 기능하는 AccessibleAWTCheckboxMenuItem