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

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

JavaTM Platform
Standard Ed. 6

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

## java.awt
클래스 Checkbox

    java.lang.Object
      java.awt.Component
          java.awt.Checkbox

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

    public class Checkbox

extends Component
implements ItemSelectable , Accessible

체크 박스는, 「온」 (`true`) 또는 「오프」 (`false`)의 어느 쪽인가의 상태를 취할 수가 있는 그래피컬 컴퍼넌트입니다. 체크 박스를 클릭하면(자), 그 상태를 「온」으로부터 「오프」에, 또는 「오프」로부터 「온」으로 변경할 수가 있습니다.

다음의 코드예에서는, 구라두 레이아웃에 체크 박스세트를 생성합니다.

>      setLayout(new GridLayout(3, 1));
>      add(new Checkbox("one", null, true));
>      add(new Checkbox("two"));
>      add(new Checkbox("three"));

이 이미지는, 이 코드예에 의해 작성되는 체크 박스와 구라두 레이아웃을 나타냅니다.

`one` 라고 하는 라벨이 붙은 버튼은 「온」 상태로, 다른 2 개의 버튼은 「오프」 상태입니다. `GridLayout` 클래스를 사용하는 이 예에서는, 3 개의 체크 박스가 각각 독립해 설정됩니다.

또,`CheckboxGroup` 클래스를 사용해, 몇개의 체크 박스를 그룹화 해 1 개의 객체로 제어할 수도 있습니다. 체크 박스 그룹에서는, 한 번에 1 개의 버튼만을 「온」 상태로 할 수 있습니다. 1 개의 체크 박스를 클릭해 온으로 하면(자), 동일 그룹내외의 체크 박스는 「오프」 상태가 됩니다.

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

상자의 클래스의 개요
`protected class` | `Checkbox.AccessibleAWTCheckbox` 이 클래스는 `Checkbox` 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.

클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스
`Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , Component.BltBufferStrategy , Component.FlipBufferStrategy`

필드의 개요

클래스 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`

생성자 의 개요
`Checkbox ()` 그 라벨이 빈 상태(empty)의 캐릭터 라인의 체크 박스를 작성합니다.
`Checkbox (String label)` 지정된 라벨이 붙은 체크 박스를 작성합니다.
`Checkbox (String label, boolean state)` 지정된 라벨이 붙은 체크 박스를 작성해, 지정된 상태로 설정합니다.
`Checkbox (String label, boolean state, CheckboxGroup group)` 지정된 라벨이 붙은 체크 박스를, 지정된 체크 박스 그룹에 구축해, 지정된 상태로 설정합니다.
`Checkbox (String label, CheckboxGroup group, boolean state)` 지정된 라벨이 붙은 체크 박스를, 지정된 체크 박스 그룹에 생성해, 지정된 상태로 설정합니다.

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

`

`<T extends EventListener > T[]`

`

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

`Object []` | `getSelectedObjects ()` 체크 박스의 라벨을 포함한 배열 (길이 1)을 돌려줍니다.
`boolean` | `getState ()` 이 체크 박스가 「온」 상태인지, 「오프」 상태인지를 판정합니다.
`protected String` | `paramString ()` 이 `Checkbox` 상태를 나타내는 캐릭터 라인을 돌려줍니다.
`protected void` | `processEvent (AWTEvent e)` 이 체크 박스로 이벤트를 처리합니다.
`protected void` | `processItemEvent (ItemEvent e)` 이 체크 박스로 발생하는 항목 이벤트를, 등록되어 있는 `ItemListener` 객체에 발송 하는 것으로써, 항목 이벤트를 처리합니다.
`void` | `removeItemListener (ItemListener l)` 이 체크 박스로부터의 항목 이벤트를 받지 않게, 지정된 항목 청취자를 삭제합니다.
`void` | `setCheckboxGroup (CheckboxGroup g)` 이 체크 박스의 그룹을, 지정된 체크 박스 그룹으로 설정합니다.
`void` | `setLabel (String label)` 이 체크 박스의 라벨을 캐릭터 라인 인수로 설정합니다.
`void` | `setState (boolean state)` 이 체크 박스 상태를, 지정된 상태로 설정합니다.

클래스 java.awt. Component 로부터 상속된 메소드
`action , add , addComponentListener , addFocusListener , addHierarchyBoundsListener , addHierarchyListener , addInputMethodListener , addKeyListener , addMouseListener , addMouseMotionListener , addMouseWheelListener , addPropertyChangeListener , addPropertyChangeListener , applyComponentOrientation , areFocusTraversalKeysSet , bounds , checkImage , checkImage , coalesceEvents , contains , contains , createImage , createImage , createVolatileImage , createVolatileImage , deliverEvent , disable , disableEvents , dispatchEvent , doLayout , enable , enable , enableEvents , enableInputMethods , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , getAlignmentX , getAlignmentY , getBackground , getBaseline , getBaselineResizeBehavior , getBounds , getBounds , getColorModel , getComponentAt , getComponentAt , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeys , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphics , getGraphicsConfiguration , getHeight , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocale , getLocation , getLocation , getLocationOnScreen , getMaximumSize , getMinimumSize , getMouseListeners , getMouseMotionListeners , getMousePosition , getMouseWheelListeners , getName , getParent , getPeer , getPreferredSize , getPropertyChangeListeners , getPropertyChangeListeners , getSize , getSize , getToolkit , getTreeLock , getWidth , getX , getY , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , invalidate , isBackgroundSet , isCursorSet , isDisplayable , isDoubleBuffered , isEnabled , isFocusable , isFocusCycleRoot , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , isMaximumSizeSet , isMinimumSizeSet , isOpaque , isPreferredSizeSet , isShowing , isValid , isVisible , keyDown , keyUp , layout , list , list , list , list , list , locate , location , lostFocus , minimumSize , mouseDown , mouseDrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , nextFocus , paint , paintAll , postEvent , preferredSize , prepareImage , prepareImage , print , printAll , processComponentEvent , processFocusEvent , processHierarchyBoundsEvent , processHierarchyEvent , processInputMethodEvent , processKeyEvent , processMouseEvent , processMouseMotionEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , removeNotify , removePropertyChangeListener , removePropertyChangeListener , repaint , repaint , repaint , repaint , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , reshape , resize , resize , setBackground , setBounds , setBounds , setComponentOrientation , setCursor , setDropTarget , setEnabled , setFocusable , setFocusTraversalKeys , setFocusTraversalKeysEnabled , setFont , setForeground , setIgnoreRepaint , setLocale , setLocation , setLocation , setMaximumSize , setMinimumSize , setName , setPreferredSize , setSize , setSize , setVisible , show , show , size , toString , transferFocus , transferFocusBackward , transferFocusUpCycle , update , validate`

클래스 java.lang. Object 로부터 상속된 메소드
`clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait`

생성자 의 상세

### Checkbox

    public Checkbox()
             throws HeadlessException

  그 라벨이 빈 상태(empty)의 캐릭터 라인의 체크 박스를 작성합니다. 이 체크 박스 상태는 「오프」로 설정되어 체크 박스 그룹에는 속하지 않습니다.

  예외:
    `HeadlessException` - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우
  관련 항목:
    `GraphicsEnvironment.isHeadless()`

### Checkbox

    public Checkbox(String  label)
             throws HeadlessException

  지정된 라벨이 붙은 체크 박스를 작성합니다. 이 체크 박스 상태는 「오프」로 설정되어 체크 박스 그룹에는 속하지 않습니다.

  파라미터:
    `label` - 이 체크 박스의 캐릭터 라인 라벨. 라벨이 없는 경우는 `null`
  예외:
    `HeadlessException` - 다음의 조건이 성립하는 경우: `GraphicsEnvironment.isHeadless` 하지만 `true` 를 돌려주는 경우
  관련 항목:
    `GraphicsEnvironment.isHeadless()`

### Checkbox

    public Checkbox(String  label,
                    boolean state)
             throws HeadlessException

  지정된 라벨이 붙은 체크 박스를 작성해, 지정된 상태로 설정합니다. 이 체크 박스는, 어느 체크 박스 그룹에도 속하지 않습니다.

  파라미터:
    `label` - 이 체크 박스의 캐릭터 라인 라벨. 라벨이 없는 경우는 `null`
    `state` - 이 체크 박스의 초기 상태
  예외:
    `HeadlessException` - 다음의 조건이 성립하는 경우: `GraphicsEnvironment.isHeadless` 하지만 `true` 를 돌려주는 경우
  관련 항목:
    `GraphicsEnvironment.isHeadless()`

### Checkbox

    public Checkbox(String  label,
                    boolean state,
                    CheckboxGroup  group)
             throws HeadlessException

  지정된 라벨이 붙은 체크 박스를, 지정된 체크 박스 그룹에 구축해, 지정된 상태로 설정합니다.

  파라미터:
    `label` - 이 체크 박스의 캐릭터 라인 라벨. 라벨이 없는 경우는 `null`
    `state` - 이 체크 박스의 초기 상태
    `group` - 이 체크 박스의 체크 박스 그룹. 그룹이 없는 경우는 `null`
  예외:
    `HeadlessException` - 다음의 조건이 성립하는 경우: `GraphicsEnvironment.isHeadless` 하지만 `true` 를 돌려주는 경우
  도입된 버젼:
    JDK1. 1
  관련 항목:
    `GraphicsEnvironment.isHeadless()`

### Checkbox

    public Checkbox(String  label,
                    CheckboxGroup  group,
                    boolean state)
             throws HeadlessException

  지정된 라벨이 붙은 체크 박스를, 지정된 체크 박스 그룹에 생성해, 지정된 상태로 설정합니다.

  파라미터:
    `label` - 이 체크 박스의 캐릭터 라인 라벨. 라벨이 없는 경우는 `null`
    `group` - 이 체크 박스의 체크 박스 그룹. 그룹이 없는 경우는 `null`
    `state` - 이 체크 박스의 초기 상태
  예외:
    `HeadlessException` - 다음의 조건이 성립하는 경우: `GraphicsEnvironment.isHeadless` 하지만 `true` 를 돌려주는 경우
  도입된 버젼:
    JDK1. 1
  관련 항목:
    `GraphicsEnvironment.isHeadless()`

메소드의 상세

### addNotify

    public void addNotify()

  체크 박스의 피어를 생성합니다. 이것에 의해, 체크 박스의 기능을 변경하는 일 없이, 그 외관을 변경하는 것이 가능하게 됩니다.

  오버라이드(override):
    클래스 `Component` 내의 `addNotify`
  관련 항목:
    `Toolkit.createCheckbox(java.awt.Checkbox)` , `Component.getToolkit()`

### getLabel

    public String  getLabel()

  체크 박스의 라벨을 돌려줍니다.

  반환값:
    이 체크 박스의 라벨. 이 체크 박스에 라벨이 없는 경우는 `null`
  관련 항목:
    `setLabel(String)`

### setLabel

    public void setLabel(String  label)

  이 체크 박스의 라벨을 캐릭터 라인 인수로 설정합니다.

  파라미터:
    `label` - 새로운 라벨로 해서 설정하는 캐릭터 라인. 라벨이 없는 경우는 `null`
  관련 항목:
    `getLabel()`

### getState

    public boolean getState()

  이 체크 박스가 「온」 상태인지, 「오프」 상태인지를 판정합니다. boolean 치 `true` 는 「온」 상태를 나타내,`false` 는 「오프」 상태를 나타냅니다.

  반환값:
    boolean 치로 나타내지는 이 체크 박스 상태
  관련 항목:
    `setState(boolean)`

### setState

    public void setState(boolean state)

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

  이 메소드는, 주로 체크 박스의 상태 초기화를 위해서(때문에) 사용해 주세요. 체크 박스의 상태를 프로그램으로 설정해도 `ItemEvent` 는 개시되지 않습니다. `ItemEvent` 를 트리거하는 유일한 방법은 사용자의 조작입니다.

  파라미터:
    `state` - boolean 치로 나타낸 체크 박스 상태
  관련 항목:
    `getState()`

### getSelectedObjects

    public Object [] getSelectedObjects()

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

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

### getCheckboxGroup

    public CheckboxGroup  getCheckboxGroup()

  이 체크 박스의 그룹을 판정합니다.

  반환값:
    이 체크 박스의 그룹. 체크 박스가 그룹에 속하지 않는 경우는 `null`
  관련 항목:
    `setCheckboxGroup(CheckboxGroup)`

### setCheckboxGroup

    public void setCheckboxGroup(CheckboxGroup  g)

  이 체크 박스의 그룹을, 지정된 체크 박스 그룹으로 설정합니다. 이 체크 박스가 벌써 다른 체크 박스 그룹에 있는 경우는, 최초로 그 그룹으로부터 삭제됩니다.

  이 체크 박스 상태가 `true` 로, 새로운 그룹의 체크 박스가 벌써 선택되고 있는 경우, 이 체크 박스 상태가 `false` 로 변경됩니다. 이 체크 박스 상태가 `true` 로, 새로운 그룹의 체크 박스가 선택되어 있지 않은 경우, 이 체크 박스는 새로운 그룹의 선택된 체크 박스가 되어, 그 상태는 `true` 입니다.

  파라미터:
    `g` - 새로운 체크 박스 그룹. 체크 박스 그룹으로부터 이 체크 박스를 삭제하는 경우는 `null`
  관련 항목:
    `getCheckboxGroup()`

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

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

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

  오버라이드(override):
    클래스 `Component` 내의 `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):
    클래스 `Component` 내의 `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)` , `Component.enableEvents(long)`

### paramString

    protected String  paramString()

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

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

### getAccessibleContext

    public AccessibleContext  getAccessibleContext()

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

  정의:
    인터페이스 `Accessible` 내의 `getAccessibleContext`
  오버라이드(override):
    클래스 `Component` 내의 `getAccessibleContext`
  반환값:
    이 Checkbox 의 AccessibleContext 으로서 기능하는 AccessibleAWTCheckbox
  도입된 버젼:
    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 도 참조해 주세요.