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