CheckboxMenuItem (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## java.awt
클래스 CheckboxMenuItem

    java.lang.Object
      java.awt.MenuComponent
          java.awt.MenuItem
              java.awt.CheckboxMenuItem

모든 구현된 인터페이스:
  ItemSelectable , Serializable , Accessible

    public class CheckboxMenuItem

extends MenuItem
implements ItemSelectable , Accessible

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

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

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

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

도입된 버젼:
  JDK1. 0
관련 항목:
  `ItemEvent` , `ItemListener` , 직렬화 된 형식

상자의 클래스의 개요
`protected class` | `CheckboxMenuItem.AccessibleAWTCheckboxMenuItem` 사용자 보조 기능의 디폴트 지원를 제공하기 위해서 사용하는 CheckboxMenuItem 의 내부 클래스입니다.

클래스 java.awt. MenuItem 로부터 상속된 상자의 클래스/인터페이스
`MenuItem.AccessibleAWTMenuItem`

클래스 java.awt. MenuComponent 로부터 상속된 상자의 클래스/인터페이스
`MenuComponent.AccessibleAWTMenuComponent`

생성자 의 개요
`CheckboxMenuItem ()` 빈 상태(empty)의 라벨이 붙은, 체크 박스 메뉴 항목을 생성합니다.
`CheckboxMenuItem (String label)` 지정된 라벨이 붙은, 체크 박스 메뉴 항목을 생성합니다.
`CheckboxMenuItem (String label, boolean state)` 지정된 라벨이 붙은 체크 박스 메뉴 항목을, 지정된 상태로 생성합니다.

메소드의 개요
`void` | `addItemListener (ItemListener l)` 지정된 항목 청취자를, 이 체크 박스의 항목 이벤트 수신을 위해서(때문에) 추가합니다.
`void` | `addNotify ()` 체크 박스 항목의 피어를 생성합니다.
`AccessibleContext` | `getAccessibleContext ()` 이 CheckboxMenuItem 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다.
`ItemListener []` | `getItemListeners ()` 이 체크 박스 메뉴 항목에 등록되어 모든 항목 청취자의 배열을 돌려줍니다.

`

`<T extends EventListener > T[]`

`

`getListeners (Class <T> listenerType)`
이 `CheckboxMenuItem` 에 `FooListener` 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다.

`Object []` | `getSelectedObjects ()` 체크 박스 메뉴 항목의 라벨을 포함한 배열 (길이 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

  빈 상태(empty)의 라벨이 붙은, 체크 박스 메뉴 항목을 생성합니다. 항목의 초기 상태는 「오프」로 설정됩니다.

  예외:
    `HeadlessException` - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우
  도입된 버젼:
    JDK1. 1
  관련 항목:
    `GraphicsEnvironment.isHeadless()`

### CheckboxMenuItem

    public CheckboxMenuItem(String  label)
                     throws HeadlessException

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

  파라미터:
    `label` - 체크 박스 메뉴 항목의 캐릭터 라인 라벨. 메뉴 항목에 라벨이 없는 경우는 `null`
  예외:
    `HeadlessException` - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우
  관련 항목:
    `GraphicsEnvironment.isHeadless()`

### CheckboxMenuItem

    public CheckboxMenuItem(String  label,
                            boolean state)
                     throws HeadlessException

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

  파라미터:
    `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()

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

  정의:
    인터페이스 `ItemSelectable` 내의 `getSelectedObjects`
  관련 항목:
    `ItemSelectable`

### addItemListener

    public void addItemListener(ItemListener  l)

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

  thread 모델의 자세한 것은,「AWT Threading Issues」를 참조해 주세요.

  정의:
    인터페이스 `ItemSelectable` 내의 `addItemListener`
  파라미터:
    `l` - 항목 청취자
  도입된 버젼:
    JDK1. 1
  관련 항목:
    `removeItemListener(java.awt.event.ItemListener)` , `getItemListeners()` , `setState(boolean)` , `ItemEvent` , `ItemListener`

### removeItemListener

    public void removeItemListener(ItemListener  l)

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

  thread 모델의 자세한 것은,「AWT Threading Issues」를 참조해 주세요.

  정의:
    인터페이스 `ItemSelectable` 내의 `removeItemListener`
  파라미터:
    `l` - 항목 청취자
  도입된 버젼:
    JDK1. 1
  관련 항목:
    `addItemListener(java.awt.event.ItemListener)` , `getItemListeners()` , `ItemEvent` , `ItemListener`

### getItemListeners

    public ItemListener [] getItemListeners()

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

  반환값:
    이 체크 박스 메뉴 항목의 모든 `ItemListener`. 항목 청취자가 현재 등록되지 않은 경우는 빈 상태(empty)의 배열
  도입된 버젼:
    1.4
  관련 항목:
    `addItemListener(java.awt.event.ItemListener)` , `removeItemListener(java.awt.event.ItemListener)` , `ItemEvent` , `ItemListener`

### getListeners

    public <T extends EventListener > T[] getListeners(Class <T> listenerType)

  이 `CheckboxMenuItem` 에 `FooListener` 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다. `FooListener` 는,`addFooListener` 메소드를 사용해 등록합니다.

  `FooListener.class` 라고 하는 클래스 리터럴을 사용해,`listenerType` 인수를 지정할 수 있습니다. 예를 들어, 이 항목 청취자에 대한 `CheckboxMenuItem` `c` 의 조회는 다음의 코드로 실시합니다. 이러한 청취자가 없는 경우는 빈 상태(empty)의 배열을 돌려줍니다.

  오버라이드(override):
    클래스 `MenuItem` 내의 `getListeners`
  파라미터:
    `listenerType` - 요구되는 청취자의 형태. ``java.util.EventListener` 의 하위 인터페이스를 지정 ```
  반환값:
    이 컴퍼넌트에 `FooListener` 로서 등록되어 모든 객체의 배열. 이 체크 박스 메뉴 항목에 `FooListener` 로서 등록되어 모든 객체의 배열. 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열
  예외:
    `ClassCastException` - `listenerType` 가 `java.util.EventListener` 를 구현하는 클래스 또는 인터페이스를 지정하지 않는 경우 ``
  도입된 버젼:
    1.3
  관련 항목:
    `getItemListeners()`

### processEvent

    protected void processEvent(AWTEvent  e)

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

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

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

  오버라이드(override):
    클래스 `MenuItem` 내의 `processEvent`
  파라미터:
    `e` - 이벤트
  도입된 버젼:
    JDK1. 1
  관련 항목:
    `ItemEvent` , `processItemEvent(java.awt.event.ItemEvent)`

### processItemEvent

    protected void processItemEvent(ItemEvent  e)

  이 체크 박스 메뉴 항목으로 발생하는 항목 이벤트를, 등록되어 있는 `ItemListener` 객체에 발송 하는 것으로써, 항목 이벤트를 처리합니다.

  이 메뉴 항목으로 항목 이벤트가 사용 가능하지 않은 경우, 이 메소드는 불려 가지 않습니다. 항목 이벤트는, 이하의 항목의 1 개가 발생했을 때에 사용 가능하게 됩니다.

  - `ItemListener` 객체가 `addItemListener` 를 사용해 등록된다
  - `enableEvents` 에 의해 항목 이벤트가 사용 가능하게 되어 있다

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

  파라미터:
    `e` - 항목 이벤트
  도입된 버젼:
    JDK1. 1
  관련 항목:
    `ItemEvent` , `ItemListener` , `addItemListener(java.awt.event.ItemListener)` , `MenuItem.enableEvents(long)`

### paramString

    public String  paramString()

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

  오버라이드(override):
    클래스 `MenuItem` 내의 `paramString`
  반환값:
    이 체크 박스 메뉴 항목의 파라미터 캐릭터 라인

### getAccessibleContext

    public AccessibleContext  getAccessibleContext()

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

  정의:
    인터페이스 `Accessible` 내의 `getAccessibleContext`
  오버라이드(override):
    클래스 `MenuItem` 내의 `getAccessibleContext`
  반환값:
    이 CheckboxMenuItem 의 AccessibleContext 으로서 기능하는 AccessibleAWTCheckboxMenuItem
  도입된 버젼:
    1.3

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.