javax.swing
클래스 JCheckBox

java.lang.Object 
  |
  +--java.awt.Component 
        |
        +--java.awt.Container 
              |
              +--javax.swing.JComponent 
                    |
                    +--javax.swing.AbstractButton 
                          |
                          +--javax.swing.JToggleButton 
                                |
                                +--javax.swing.JCheckBox

모든 구현 인터페이스:

Accessible , ImageObserver , ItemSelectable , MenuContainer , Serializable , SwingConstants

public class JCheckBox

extends JToggleButton

implements Accessible

체크 박스, 즉 선택 혹은 선택 해제할 수 있는 항목의 구현으로, 그 상태를 표시합니다. 규칙에 따라, 그룹으로부터 임의의 수의 체크 박스를 선택할 수 있습니다. 체크 박스 사용에 관한 예와 정보에 대해서는 「The Java Tutorial」의 「How to Use Buttons, Check Boxes, and Radio Buttons」를 참조해 주세요.

표준의 Look & Feel (L&F) 표현으로 이 컴퍼넌트가 사용하는 키보드의 키에 대해서는 「JCheckBox 의 키의 할당」 을 참조해 주세요.

경고: 이 클래스의 직렬화 오브젝트는 향후 릴리스 되는 Swing 와의 호환성은 없습니다. 현재 서포트되고 있는 직렬화는 단기간의 보관, 또는 같은 버젼의 Swing 가 가동하고 있는 어플리케이션간의 RMI 에 적절하고 있습니다. 1.4 로부터는 모든 JavaBeans^TM 의 장기간의 보관이 java.beans 패키지로 추가 서포트되고 있습니다. XMLEncoder 를 참조해 주세요.

관련 항목:

JRadioButton

중첩된 클래스의 개요

protected class

JCheckBox.AccessibleJCheckBox 이 클래스는 JCheckBox 클래스용의 유저 보조 기능의 서포트를 구현하고 있습니다.

클래스 javax.swing. JToggleButton 을 상속받은 중첩된 클래스

JToggleButton.ToggleButtonModel

클래스 javax.swing. AbstractButton 을 상속받은 중첩된 클래스

AbstractButton.ButtonChangeListener

클래스 javax.swing. JComponent 을 상속받은 중첩된 클래스

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

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

Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

static String

BORDER_PAINTED_FLAT_CHANGED_PROPERTY flat 프로퍼티에 대한 변경을 식별합니다.

클래스 javax.swing. AbstractButton 에서 상속받은 필드

actionListener , BORDER_PAINTED_CHANGED_PROPERTY , changeEvent , changeListener , CONTENT_AREA_FILLED_CHANGED_PROPERTY , DISABLED_ICON_CHANGED_PROPERTY , DISABLED_SELECTED_ICON_CHANGED_PROPERTY , FOCUS_PAINTED_CHANGED_PROPERTY , HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY , HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY , ICON_CHANGED_PROPERTY , itemListener , MARGIN_CHANGED_PROPERTY , MNEMONIC_CHANGED_PROPERTY , model , MODEL_CHANGED_PROPERTY , PRESSED_ICON_CHANGED_PROPERTY , ROLLOVER_ENABLED_CHANGED_PROPERTY , ROLLOVER_ICON_CHANGED_PROPERTY , ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY , SELECTED_ICON_CHANGED_PROPERTY , TEXT_CHANGED_PROPERTY , VERTICAL_ALIGNMENT_CHANGED_PROPERTY , VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

클래스 javax.swing. JComponent 에서 상속받은 필드

accessibleContext , listenerList , TOOL_TIP_TEXT_KEY , ui , UNDEFINED_CONDITION , WHEN_ANCESTOR_OF_FOCUSED_COMPONENT , WHEN_FOCUSED , WHEN_IN_FOCUSED_WINDOW

클래스 java.awt. Component 에서 상속받은 필드

BOTTOM_ALIGNMENT , CENTER_ALIGNMENT , LEFT_ALIGNMENT , RIGHT_ALIGNMENT , TOP_ALIGNMENT

인터페이스 javax.swing. SwingConstants 에서 상속받은 필드

BOTTOM , CENTER , EAST , HORIZONTAL , LEADING , LEFT , NEXT , NORTH , NORTH_EAST , NORTH_WEST , PREVIOUS , RIGHT , SOUTH , SOUTH_EAST , SOUTH_WEST , TOP , TRAILING , VERTICAL , WEST

인터페이스 java.awt.image. ImageObserver 에서 상속받은 필드

ABORT , ALLBITS , ERROR , FRAMEBITS , HEIGHT , PROPERTIES , SOMEBITS , WIDTH

생성자의 개요

JCheckBox ()
초기 상태로 선택되어 있지 않은 텍스트 및 아이콘 없음의 체크 박스 버튼을 생성합니다.

JCheckBox (Action a)
지정된 Action 로부터 프로퍼티를 취득하는 체크 박스를 생성합니다.

JCheckBox (Icon icon)
초기 상태로 선택되어 있지 않은 아이콘 첨부의 체크 박스를 생성합니다.

JCheckBox (Icon icon, boolean selected)
아이콘 첨부의 체크 박스를 생성해, 그것이 초기 상태로 선택될지 어떨지를 지정합니다.

JCheckBox (String text)
초기 상태로 선택되어 있지 않은 텍스트 첨부의 체크 박스를 생성합니다.

JCheckBox (String text, boolean selected)
텍스트 첨부의 체크 박스를 생성해, 그것이 초기 상태로 선택될지 어떨지를 지정합니다.

JCheckBox (String text, Icon icon)
초기 상태로 선택되어 있지 않은 지정된 텍스트 및 아이콘 첨부의 체크 박스를 생성합니다.

JCheckBox (String text, Icon icon, boolean selected)
텍스트 및 아이콘 첨부의 체크 박스를 생성해, 그것이 초기 상태로 선택될지 어떨지를 지정합니다.

메소드의 개요

protected void	configurePropertiesFromAction (Action a) Action 인스턴스의 값에 따라 ActionEvent 소스의 프로퍼티를 설정하는 팩토리 메소드입니다.
protected PropertyChangeListener	createActionPropertyChangeListener (Action a) PropertyChangeListener 를 생성하는 팩토리 메소드입니다.
AccessibleContext	getAccessibleContext () 이 JCheckBox 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다.
String	getUIClassID () 이 컴퍼넌트를 표현 하는 L&F 클래스의 이름을 지정하는 캐릭터 라인으로 돌려줍니다.
boolean	isBorderPaintedFlat () borderPaintedFlat 프로퍼티의 값을 취득합니다.
protected String	paramString () 이 JCheckBox 의 캐릭터 라인 표현을 돌려줍니다.
void	setBorderPaintedFlat (boolean b) 체크 박스 보더의 외관에 대한 힌트를 Look & Feel (L&F)에게 주는 borderPaintedFlat 프로퍼티를 설정합니다.
void	updateUI () 현재의 Look & Feel (L&F)로부터의 값에 UI 프로퍼티를 리셋트 합니다.

클래스 javax.swing. AbstractButton 에서 상속받은 메소드

addActionListener , addChangeListener , addItemListener , checkHorizontalKey , checkVerticalKey , createActionListener , createChangeListener , createItemListener , doClick , doClick , fireActionPerformed , fireItemStateChanged , fireStateChanged , getAction , getActionCommand , getActionListeners , getChangeListeners , getDisabledIcon , getDisabledSelectedIcon , getDisplayedMnemonicIndex , getHorizontalAlignment , getHorizontalTextPosition , getIcon , getIconTextGap , getItemListeners , getLabel , getMargin , getMnemonic , getModel , getMultiClickThreshhold , getPressedIcon , getRolloverIcon , getRolloverSelectedIcon , getSelectedIcon , getSelectedObjects , getText , getUI , getVerticalAlignment , getVerticalTextPosition , imageUpdate , init , isBorderPainted , isContentAreaFilled , isFocusPainted , isRolloverEnabled , isSelected , paintBorder , removeActionListener , removeChangeListener , removeItemListener , setAction , setActionCommand , setBorderPainted , setContentAreaFilled , setDisabledIcon , setDisabledSelectedIcon , setDisplayedMnemonicIndex , setEnabled , setFocusPainted , setHorizontalAlignment , setHorizontalTextPosition , setIcon , setIconTextGap , setLabel , setMargin , setMnemonic , setMnemonic , setModel , setMultiClickThreshhold , setPressedIcon , setRolloverEnabled , setRolloverIcon , setRolloverSelectedIcon , setSelected , setSelectedIcon , setText , setUI , setVerticalAlignment , setVerticalTextPosition

클래스 javax.swing. JComponent 에서 상속받은 메소드

addAncestorListener , addNotify , addPropertyChangeListener , addPropertyChangeListener , addVetoableChangeListener , computeVisibleRect , contains , createToolTip , disable , enable , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , fireVetoableChange , getActionForKeyStroke , getActionMap , getAlignmentX , getAlignmentY , getAncestorListeners , getAutoscrolls , getBorder , getBounds , getClientProperty , getComponentGraphics , getConditionForKeyStroke , getDebugGraphicsOptions , getDefaultLocale , getGraphics , getHeight , getInputMap , getInputMap , getInputVerifier , getInsets , getInsets , getListeners , getLocation , getMaximumSize , getMinimumSize , getNextFocusableComponent , getPreferredSize , getPropertyChangeListeners , getPropertyChangeListeners , getRegisteredKeyStrokes , getRootPane , getSize , getToolTipLocation , getToolTipText , getToolTipText , getTopLevelAncestor , getTransferHandler , getVerifyInputWhenFocusTarget , getVetoableChangeListeners , getVisibleRect , getWidth , getX , getY , grabFocus , isDoubleBuffered , isLightweightComponent , isManagingFocus , isMaximumSizeSet , isMinimumSizeSet , isOpaque , isOptimizedDrawingEnabled , isPaintingTile , isPreferredSizeSet , isRequestFocusEnabled , isValidateRoot , paint , paintChildren , paintComponent , paintImmediately , paintImmediately , print , printAll , printBorder , printChildren , printComponent , processComponentKeyEvent , processKeyBinding , processKeyEvent , processMouseMotionEvent , putClientProperty , registerKeyboardAction , registerKeyboardAction , removeAncestorListener , removeNotify , removePropertyChangeListener , removePropertyChangeListener , removeVetoableChangeListener , repaint , repaint , requestDefaultFocus , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , resetKeyboardActions , reshape , revalidate , scrollRectToVisible , setActionMap , setAlignmentX , setAlignmentY , setAutoscrolls , setBackground , setBorder , setDebugGraphicsOptions , setDefaultLocale , setDoubleBuffered , setFont , setForeground , setInputMap , setInputVerifier , setMaximumSize , setMinimumSize , setNextFocusableComponent , setOpaque , setPreferredSize , setRequestFocusEnabled , setToolTipText , setTransferHandler , setUI , setVerifyInputWhenFocusTarget , setVisible , unregisterKeyboardAction , update

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

add , add , add , add , add , addContainerListener , addImpl , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getLayout , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , preferredSize , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setFocusCycleRoot , setFocusTraversalKeys , setFocusTraversalPolicy , setLayout , transferFocusBackward , transferFocusDownCycle , validate , validateTree

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

action , add , addComponentListener , addFocusListener , addHierarchyBoundsListener , addHierarchyListener , addInputMethodListener , addKeyListener , addMouseListener , addMouseMotionListener , addMouseWheelListener , bounds , checkImage , checkImage , coalesceEvents , contains , createImage , createImage , createVolatileImage , createVolatileImage , disableEvents , dispatchEvent , enable , enableEvents , enableInputMethods , getBackground , getBounds , getColorModel , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphicsConfiguration , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocale , getLocation , getLocationOnScreen , getMouseListeners , getMouseMotionListeners , getMouseWheelListeners , getName , getParent , getPeer , getSize , getToolkit , getTreeLock , gotFocus , handleEvent , hasFocus , hide , inside , isBackgroundSet , isCursorSet , isDisplayable , isEnabled , isFocusable , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , isShowing , isValid , isVisible , keyDown , keyUp , list , list , list , location , lostFocus , mouseDown , mouseDrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , nextFocus , paintAll , postEvent , prepareImage , prepareImage , processComponentEvent , processFocusEvent , processHierarchyBoundsEvent , processHierarchyEvent , processInputMethodEvent , processMouseEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , repaint , repaint , repaint , resize , resize , setBounds , setBounds , setComponentOrientation , setCursor , setDropTarget , setFocusable , setFocusTraversalKeysEnabled , setIgnoreRepaint , setLocale , setLocation , setLocation , setName , setSize , setSize , show , show , size , toString , transferFocus , transferFocusUpCycle

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

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

필드의 상세

BORDER_PAINTED_FLAT_CHANGED_PROPERTY

public static final String  BORDER_PAINTED_FLAT_CHANGED_PROPERTY

flat 프로퍼티에 대한 변경을 식별합니다.

관련 항목:

정수 필드치

생성자의 상세

JCheckBox

public JCheckBox()

초기 상태로 선택되어 있지 않은 텍스트 및 아이콘 없음의 체크 박스 버튼을 생성합니다.

JCheckBox

public JCheckBox(Icon  icon)

초기 상태로 선택되어 있지 않은 아이콘 첨부의 체크 박스를 생성합니다.

파라미터:

icon - 표시하는 Icon 이미지

JCheckBox

public JCheckBox(Icon  icon,
                 boolean selected)

아이콘 첨부의 체크 박스를 생성해, 그것이 초기 상태로 선택될지 어떨지를 지정합니다.

파라미터:

icon - 표시하는 Icon 이미지

selected - 초기 선택 상태를 나타내는 boolean 치. true 의 경우, 체크 박스가 선택된다

JCheckBox

public JCheckBox(String  text)

초기 상태로 선택되어 있지 않은 텍스트 첨부의 체크 박스를 생성합니다.

파라미터:

text - 체크 박스의 텍스트

JCheckBox

public JCheckBox(Action  a)

지정된 Action 로부터 프로퍼티를 취득하는 체크 박스를 생성합니다.

도입된 버젼:

1.3

JCheckBox

public JCheckBox(String  text,
                 boolean selected)

텍스트 첨부의 체크 박스를 생성해, 그것이 초기 상태로 선택될지 어떨지를 지정합니다.

파라미터:

text - 체크 박스의 텍스트

selected - 초기 선택 상태를 나타내는 boolean 치. true 의 경우, 체크 박스가 선택된다

JCheckBox

public JCheckBox(String  text,
                 Icon  icon)

초기 상태로 선택되어 있지 않은 지정된 텍스트 및 아이콘 첨부의 체크 박스를 생성합니다.

파라미터:

text - 체크 박스의 텍스트

icon - 표시하는 Icon 이미지

JCheckBox

public JCheckBox(String  text,
                 Icon  icon,
                 boolean selected)

텍스트 및 아이콘 첨부의 체크 박스를 생성해, 그것이 초기 상태로 선택될지 어떨지를 지정합니다.

파라미터:

text - 체크 박스의 텍스트

icon - 표시하는 Icon 이미지

selected - 초기 선택 상태를 나타내는 boolean 치. true 의 경우, 체크 박스가 선택된다

메소드의 상세

setBorderPaintedFlat

public void setBorderPaintedFlat(boolean b)

체크 박스 보더의 외관에 대한 힌트를 Look & Feel (L&F)에게 주는 borderPaintedFlat 프로퍼티를 설정합니다. JCheckBox 인스턴스가 JTable 나 JTree 등의 컴퍼넌트로 렌더링으로서 사용되고 있는 경우, 이 프로퍼티는 통상 true 로 설정됩니다. borderPaintedFlat 프로퍼티의 디폴트 값은 false 입니다. 이 메소드는 프로퍼티 변경 이벤트를 방아쇠 합니다. 균일한 보더를 구현하지 않는 Look & Feel (L&F)에서는 이 프로퍼티는 무시됩니다.

파라미터:

b - true 의 경우는 보더의 균일한 paint가 요구되어false 의 경우는 통상의 보더 paint가 요구됩니다.

관련 항목:

isBorderPaintedFlat()

isBorderPaintedFlat

public boolean isBorderPaintedFlat()

borderPaintedFlat 프로퍼티의 값을 취득합니다.

반환값:

borderPaintedFlat 프로퍼티의 값

관련 항목:

setBorderPaintedFlat(boolean)

updateUI

public void updateUI()

현재의 Look & Feel (L&F)로부터의 값에 UI 프로퍼티를 리셋트 합니다.

오버라이드(override):

클래스 JToggleButton 내의 updateUI

관련 항목:

JComponent.updateUI()

getUIClassID

public String  getUIClassID()

이 컴퍼넌트를 표현 하는 L&F 클래스의 이름을 지정하는 캐릭터 라인으로 돌려줍니다.

오버라이드(override):

클래스 JToggleButton 내의 getUIClassID

반환값:

CheckBoxUI 의 캐릭터 라인

관련 항목:

JComponent.getUIClassID() , UIDefaults.getUI(javax.swing.JComponent)

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action  a)

Action 인스턴스의 값에 따라 ActionEvent 소스의 프로퍼티를 설정하는 팩토리 메소드입니다. 설정되는 프로퍼티는 서브 클래스에 의해 다릅니다. 디폴트에서는 설정되는 프로퍼티는 Text, Mnemonic, Enabled, ActionCommand, 및 ToolTipText 입니다.

오버라이드(override):

클래스 AbstractButton 내의 configurePropertiesFromAction

파라미터:

a - 프로퍼티의 취득원 Action, 또는 null

도입된 버젼:

1.3

관련 항목:

Action , AbstractButton.setAction(javax.swing.Action)

createActionPropertyChangeListener

protected PropertyChangeListener  createActionPropertyChangeListener(Action  a)

PropertyChangeListener 를 생성하는 팩토리 메소드입니다. 이 메소드는 Action 인스턴스의 프로퍼티 변경에 따라, ActionEvent 소스를 갱신하기 위해서 사용됩니다. 최신 상태로 보관 유지될 필요가 있는 프로퍼티 세트가 디폴트의 프로퍼티 (Text, Icon, Enabled, ToolTipText)와 다른 경우, 독자적인 PropertyChangeListener 를 실행하기 위해서, 서브 클래스에서 이 메소드가 오버라이드(override) 되는 경우가 있습니다. PropertyChangeListener 가 ActionEvent 소스에의 강참조를 보관 유지하지 않게 해 주세요. 강참조가 있는 경우 ActionEvent 소스와 그 포함 관계의 계층에 있는 모든 컴퍼넌트의 가베지 콜렉션을 방해할 가능성이 있기 (위해)때문에입니다.

오버라이드(override):

클래스 AbstractButton 내의 createActionPropertyChangeListener

파라미터:

a - 버튼의 새로운 액션

도입된 버젼:

1.3

관련 항목:

Action , AbstractButton.setAction(javax.swing.Action)

paramString

protected String  paramString()

이 JCheckBox 의 캐릭터 라인 표현을 돌려줍니다. 이 메소드는 디버그 전용이며, 돌려주어지는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 돌려주어지는 캐릭터 라인은 비었을 경우가 있습니다만,null 로는 되지 않습니다. 이것은 JFC 컴퍼넌트의 새로운 특수한 면입니다.

오버라이드(override):

클래스 JToggleButton 내의 paramString

반환값:

이 JCheckBox 의 캐릭터 라인 표현

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 JCheckBox 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다. JCheckBox 의 경우, AccessibleContext 는 AccessibleJCheckBox 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleJChecBox 인스턴스가 생성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 JToggleButton 내의 getAccessibleContext

반환값:

이 JCheckBox 의 AccessibleContext 로서 기능하는 AccessibleJCheckBox