javax.swing
인터페이스 ButtonModel

모든 슈퍼 인터페이스:

ItemSelectable

기존의 구현 클래스의 일람:

DefaultButtonModel , JToggleButton.ToggleButtonModel

public interface ButtonModel
extends ItemSelectable 

버튼 상태 모델입니다.

이 모델은, 체크 박스나 라디오 버튼등이 특수한 버튼에도, 일반적으로의 버튼에도와 같이 사용합니다. 나중에 설명합니다만, 실제로 상태를 관리하기 위해서 모델상에서 메소드를 호출하는 것은, 버튼의 UI 입니다.

간단하게 말하면(자), 일반적으로의 버튼 위에서 mouse button를 눌러 손가락을 떼어 놓으면(자), 버튼이 트리거되어ActionEvent 가 트리거됩니다. 버튼의 Look & Feel 에 의해 정의되고 있는 키보드 키 (전형예는 스페이스 바)에서도, 같은 동작을 실시할 수 있습니다. 버튼이 포커스 된 상태로 이 키를 눌러 손가락을 떼어 놓으면(자), 같은 결과가 됩니다. 체크 박스와 라디오 버튼의 경우, 여기서 설명한 것 같은 마우스 또는 키보드의 조작으로, 버튼이 선택됩니다.

버튼 상태 모델은, 마우스의 조작에 의해, 다음과 같이 기능합니다.
버튼상에서 mouse button를 누르면(자), 모델에서는 작동 준비 상태와 밀린 상태의 양쪽 모두가 됩니다. mouse button를 눌러 내리고 있는 동안은, 마우스를 버튼의 외측에 이동해도, 모델에서는 밀린 상태대로 됩니다. 반대로, 모델이 작동 준비 상태가 되는 것은, 버튼의 경계내에서 mouse button가 밀리고 있는 동안 뿐입니다. 마우스를 버튼의 외측에 이동할 수 있습니다만, 모델이 작동 준비 상태가 되는 것은, 마우스가 버튼의 경계내에 있는 동안 뿐입니다. 버튼상에서 mouse button를 눌러, 손가락을 떼어 놓지 않은 채 유지해, 모델이 작동 준비 상태가 되어 있는 동안에 버튼상에서 mouse button로부터 손가락을 떼어 놓으면(자), 버튼이 트리거되어ActionEvent 가 트리거됩니다. mouse button로부터 손가락을 떼어 놓은 순간, 모델의 작동 준비 상태와 밀린 상태가 해제됩니다.

버튼 상태 모델은, 키보드의 조작에 의해, 다음과 같이 기능합니다.
버튼에 포커스가 있는 상태로, Look & Feel 에 의해 정의된 키보드 키를 누르면(자), 모델에서는 작동 준비 상태와 밀린 상태의 양쪽 모두가 됩니다. 이 키를 누르고 있는 동안, 모델은 이 상태를 보관 유지합니다. 키로부터 손가락을 떼어 놓으면(자), 모델의 작동 준비 상태와 밀린 상태가 해제되어 버튼이 트리거되어 이것을 받아 ActionEvent 가 트리거됩니다.

메소드의 개요

void	addActionListener (ActionListener l) 모델에 ActionListener 을 추가합니다.
void	addChangeListener (ChangeListener l) 모델에 ChangeListener 를 추가합니다.
void	addItemListener (ItemListener l) 모델에 ItemListener 를 추가합니다.
String	getActionCommand () 버튼의 액션 커멘드 캐릭터 라인을 돌려줍니다.
int	getMnemonic () 버튼의 키보드 니마닉(mnemonic)를 돌려줍니다.
boolean	isArmed () 버튼이 작동 준비 상태인 것을 나타냅니다.
boolean	isEnabled () 마우스 포인터등의 입력 디바이스로, 버튼을 선택하거나 트리거하거나 할 수 있을지 어떨지를 나타냅니다.
boolean	isPressed () 버튼이 밀리고 있는지 어떤지를 나타냅니다.
boolean	isRollover () 마우스 포인터가 버튼 위에 있을지 어떨지를 나타냅니다.
boolean	isSelected () 버튼이 선택되고 있는지 어떤지를 나타냅니다.
void	removeActionListener (ActionListener l) 모델로부터 ActionListener 를 삭제합니다.
void	removeChangeListener (ChangeListener l) 모델로부터 ChangeListener 를 삭제합니다.
void	removeItemListener (ItemListener l) 모델로부터 ItemListener 를 삭제합니다.
void	setActionCommand (String s) 버튼이 트리거되었을 때에 ActionEvent 의 일부로서 보내지는 액션 커멘드 캐릭터 라인을 설정합니다.
void	setArmed (boolean b) 버튼을 작동 준비 상태 또는 작동 준비가 해제된 상태로서 마크 합니다.
void	setEnabled (boolean b) 버튼을 유효 또는 무효로 합니다.
void	setGroup (ButtonGroup group) 버튼이 속하는 그룹을 식별합니다.
void	setMnemonic (int key) 버튼의 키보드 니마닉(mnemonic) (단축 키 또는 가속기 키)를 설정합니다.
void	setPressed (boolean b) 버튼을 밀린 상태 또는 밀리지 않은 상태로 설정합니다.
void	setRollover (boolean b) 버튼의 롤 오버 상태를 설정 또는 해제합니다.
void	setSelected (boolean b) 버튼을 선택 또는 선택 해제합니다.

인터페이스 java.awt. ItemSelectable 로부터 상속된 메소드

getSelectedObjects

메소드의 상세

isArmed

boolean isArmed()

버튼이 작동 준비 상태인 것을 나타냅니다.

반환값:

버튼이 작동 준비 상태로, 트리거될 준비가 되어 있는 경우는 true

관련 항목:

setArmed(boolean)

isSelected

boolean isSelected()

버튼이 선택되고 있는지 어떤지를 나타냅니다. 라디오 버튼이나 체크 박스등의 특정의 종류의 버튼에만 필요합니다.

반환값:

버튼이 선택되고 있는 경우는 true

isEnabled

boolean isEnabled()

마우스 포인터등의 입력 디바이스로, 버튼을 선택하거나 트리거하거나 할 수 있을지 어떨지를 나타냅니다.

반환값:

버튼이 유효한 경우는 true

isPressed

boolean isPressed()

버튼이 밀리고 있는지 어떤지를 나타냅니다.

반환값:

버튼이 밀리고 있는 경우는 true

isRollover

boolean isRollover()

마우스 포인터가 버튼 위에 있을지 어떨지를 나타냅니다.

반환값:

마우스 포인터가 버튼 위에 있는 경우는 true

setArmed

void setArmed(boolean b)

버튼을 작동 준비 상태 또는 작동 준비가 해제된 상태로서 마크 합니다.

파라미터:

b - 버튼을 작동 준비 상태로 할지 어떨지

setSelected

void setSelected(boolean b)

버튼을 선택 또는 선택 해제합니다.

파라미터:

b - 버튼을 선택하는 경우는 true, 선택을 해제하는 경우는 false

setEnabled

void setEnabled(boolean b)

버튼을 유효 또는 무효로 합니다.

파라미터:

b - 버튼을 유효하게 할지 어떨지

관련 항목:

isEnabled()

setPressed

void setPressed(boolean b)

버튼을 밀린 상태 또는 밀리지 않은 상태로 설정합니다.

파라미터:

b - 버튼을 밀린 상태로 할지 어떨지

관련 항목:

isPressed()

setRollover

void setRollover(boolean b)

버튼의 롤 오버 상태를 설정 또는 해제합니다.

파라미터:

b - 버튼이 롤 오버 상태인가 어떤가

관련 항목:

isRollover()

setMnemonic

void setMnemonic(int key)

버튼의 키보드 니마닉(mnemonic) (단축 키 또는 가속기 키)를 설정합니다.

파라미터:

key - 가속기 키를 지정하는 정수치

getMnemonic

int getMnemonic()

버튼의 키보드 니마닉(mnemonic)를 돌려줍니다.

반환값:

가속기 키를 지정하는 정수치

관련 항목:

setMnemonic(int)

setActionCommand

void setActionCommand(String  s)

버튼이 트리거되었을 때에 ActionEvent 의 일부로서 보내지는 액션 커멘드 캐릭터 라인을 설정합니다.

파라미터:

s - 생성한 이벤트를 식별하는 String

관련 항목:

getActionCommand() , ActionEvent.getActionCommand()

getActionCommand

String  getActionCommand()

버튼의 액션 커멘드 캐릭터 라인을 돌려줍니다.

반환값:

생성한 이벤트를 식별하는 String

관련 항목:

setActionCommand(java.lang.String)

setGroup

void setGroup(ButtonGroup  group)

버튼이 속하는 그룹을 식별합니다. 이것은, 그룹내에서 배타적인 선택을 하는 라디오 버튼에 필요합니다.

파라미터:

group - 버튼이 속하는 ButtonGroup

addActionListener

void addActionListener(ActionListener  l)

모델에 ActionListener 를 추가합니다.

파라미터:

l - 추가하는 청취자

removeActionListener

void removeActionListener(ActionListener  l)

모델로부터 ActionListener 를 삭제합니다.

파라미터:

l - 삭제하는 청취자

addItemListener

void addItemListener(ItemListener  l)

모델에 ItemListener 를 추가합니다.

정의:

인터페이스 ItemSelectable 내의 addItemListener

파라미터:

l - 추가하는 청취자

관련 항목:

ItemEvent

removeItemListener

void removeItemListener(ItemListener  l)

모델로부터 ItemListener 를 삭제합니다.

정의:

인터페이스 ItemSelectable 내의 removeItemListener

파라미터:

l - 삭제하는 청취자

관련 항목:

ItemEvent

addChangeListener

void addChangeListener(ChangeListener  l)

모델에 ChangeListener 를 추가합니다.

파라미터:

l - 추가하는 청취자

removeChangeListener

void removeChangeListener(ChangeListener  l)

모델로부터 ChangeListener 를 삭제합니다.

파라미터:

l - 삭제하는 청취자