javax.swing
類別 DefaultButtonModel

java.lang.Object
  javax.swing.DefaultButtonModel

所有已實作的介面：

ItemSelectable, Serializable, ButtonModel

直接已知子類別：

JToggleButton.ToggleButtonModel

public class DefaultButtonModel
extends Object
implements ButtonModel, Serializable

Button 元件的資料模型的預設實作。

警告：此類別的序列化物件將與以後的 Swing 版本不相容。當前的序列化支持適用於短期存儲或運行相同 Swing 版本的應用程序之間的 RMI。從 1.4 版本開始，已在 java.beans 套件中添加了支持所有 JavaBeans^TM 長期存儲的功能。請參見 XMLEncoder。

欄位摘要

protected String	actionCommand 按鈕所觸發的動作命令字元串。
static int	ARMED 標識位遮罩碼中「選中的」位，該位指示選擇/觸發按鈕操作的部分委託事項。
protected ChangeEvent	changeEvent 每個按鈕模型實例只需要一個 ChangeEvent，因為事件的唯一狀態是源屬性。
static int	ENABLED 標識位遮罩碼中「啟用的」位，該位指示可以通過輸入設備（如鼠標指針）選擇按鈕。
protected ButtonGroup	group 按鈕所屬的按鈕組。
protected EventListenerList	listenerList 在此模型中存儲偵聽器。
protected int	mnemonic 按鈕的助記符。
static int	PRESSED 標識位遮罩碼中「按下的」位，該位指示按鈕已經被按下。
static int	ROLLOVER 標識位遮罩碼中「翻轉的」位，該位指示鼠標位於按鈕上。
static int	SELECTED 標識位遮罩碼中「選定的」位，該位指示按紐已被選定。
protected int	stateMask 用於存儲按鈕狀態的位遮罩碼。

建構子摘要

DefaultButtonModel()
建構一個 DefaultButtonModel。

方法摘要

void	addActionListener(ActionListener l) 向模型添加一個 ActionListener。
void	addChangeListener(ChangeListener l) 向模型添加一個 ChangeListener。
void	addItemListener(ItemListener l) 向模型添加一個 ItemListener。
protected void	fireActionPerformed(ActionEvent e) 通知所有對此事件型別的通知感興趣的已註冊偵聽器。
protected void	fireItemStateChanged(ItemEvent e) 通知所有對此事件型別的通知感興趣的已註冊偵聽器。
protected void	fireStateChanged() 通知所有對此事件型別的通知感興趣的已註冊偵聽器。
String	getActionCommand() 返回該按鈕的動作命令字元串。
ActionListener[]	getActionListeners() 返回此 DefaultButtonModel 上所有已註冊的操作偵聽器組成的陣列。
ChangeListener[]	getChangeListeners() 返回此 DefaultButtonModel 上所有已註冊的更改偵聽器組成的陣列。
ButtonGroup	getGroup() 返回該按鈕所屬的組。
ItemListener[]	getItemListeners() 返回此 DefaultButtonModel 上所有已註冊的項偵聽器組成的陣列。
<T extends EventListener> T[]	getListeners(Class<T> listenerType) 返回目前已在此模型上註冊為 FooListener 的所有物件組成的陣列。
int	getMnemonic() 獲取該按鈕的鍵盤助記符。
Object[]	getSelectedObjects() 覆寫以返回 null。
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 actionCommand) 設置動作命令字元串，在觸發按鈕時，該字元串將作為 ActionEvent 的一部分被發送。
void	setArmed(boolean b) 將此按鈕標記為選中或未選中。
void	setEnabled(boolean b) 啟用或禁用該按鈕。
void	setGroup(ButtonGroup group) 標識該按鈕所屬的組，這是單選鈕所需要的，單選鈕在它們的組內相互排斥。
void	setMnemonic(int key) 設置該按鈕的鍵盤助記符（快捷鍵或加速鍵）。
void	setPressed(boolean b) 將按鈕設置為按下或未被按下。
void	setRollover(boolean b) 設置或清除該按鈕的翻轉狀態
void	setSelected(boolean b) 選擇或取消選擇該按鈕。

從類別 java.lang.Object 繼承的方法

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

欄位詳細資訊

stateMask

protected int stateMask

用於存儲按鈕狀態的位遮罩碼。

actionCommand

protected String actionCommand

按鈕所觸發的動作命令字元串。

group

protected ButtonGroup group

按鈕所屬的按鈕組。

mnemonic

protected int mnemonic

按鈕的助記符。

changeEvent

protected transient ChangeEvent changeEvent

每個按鈕模型實例只需要一個 ChangeEvent，因為事件的唯一狀態是源屬性。所產生事件的源總是 "this"。

listenerList

protected EventListenerList listenerList

在此模型中存儲偵聽器。

ARMED

public static final int ARMED

標識位遮罩碼中「選中的」位，該位指示選擇/觸發按鈕操作的部分委託事項。

另請參見：

常數欄位值

SELECTED

public static final int SELECTED

標識位遮罩碼中「選定的」位，該位指示按紐已被選定。只有某些型別的按鈕需要該指示，比如單選鈕或複選框。

另請參見：

常數欄位值

PRESSED

public static final int PRESSED

標識位遮罩碼中「按下的」位，該位指示按鈕已經被按下。

另請參見：

常數欄位值

ENABLED

public static final int ENABLED

標識位遮罩碼中「啟用的」位，該位指示可以通過輸入設備（如鼠標指針）選擇按鈕。

另請參見：

常數欄位值

ROLLOVER

public static final int ROLLOVER

標識位遮罩碼中「翻轉的」位，該位指示鼠標位於按鈕上。

另請參見：

常數欄位值

建構子詳細資訊

DefaultButtonModel

public DefaultButtonModel()

建構一個 DefaultButtonModel。

方法詳細資訊

setActionCommand

public void setActionCommand(String actionCommand)

設置動作命令字元串，在觸發按鈕時，該字元串將作為 ActionEvent 的一部分被發送。

指定者：

介面 ButtonModel 中的 setActionCommand

參數：

actionCommand - 標識產生的事件的 String

另請參見：

ButtonModel.getActionCommand(), ActionEvent.getActionCommand()

getActionCommand

public String getActionCommand()

返回該按鈕的動作命令字元串。

指定者：

介面 ButtonModel 中的 getActionCommand

返回：

標識產生的事件的 String

另請參見：

ButtonModel.setActionCommand(java.lang.String)

isArmed

public boolean isArmed()

指示觸發按鈕操作的部分委託事項。

指定者：

介面 ButtonModel 中的 isArmed

返回：

如果按鈕被選中，並準備觸發它，則返回 true

另請參見：

ButtonModel.setArmed(boolean)

isSelected

public boolean isSelected()

指示按鈕是否已經被選擇。只有某些型別的按鈕需要此指示，比如單選鈕和複選框。

指定者：

介面 ButtonModel 中的 isSelected

返回：

如果按鈕已選擇，則返回 true

isEnabled

public boolean isEnabled()

指示是否可通過輸入設備（比如鼠標指針）選擇或觸發按鈕。

指定者：

介面 ButtonModel 中的 isEnabled

返回：

如果啟用按鈕，則返回 true

isPressed

public boolean isPressed()

指示按鈕是否已被按下。

指定者：

介面 ButtonModel 中的 isPressed

返回：

如果按鈕已被按下，則返回 true

isRollover

public boolean isRollover()

指示鼠標是否在按鈕上。

指定者：

介面 ButtonModel 中的 isRollover

返回：

如果鼠標在按鈕上，則返回 true

setArmed

public void setArmed(boolean b)

將此按鈕標記為選中或未選中。

指定者：

介面 ButtonModel 中的 setArmed

參數：

b - 是否應該選中該按鈕

setEnabled

public void setEnabled(boolean b)

啟用或禁用該按鈕。

指定者：

介面 ButtonModel 中的 setEnabled

參數：

b - 是否應該啟用該按鈕

另請參見：

ButtonModel.isEnabled()

setSelected

public void setSelected(boolean b)

選擇或取消選擇該按鈕。

指定者：

介面 ButtonModel 中的 setSelected

參數：

b - 為 true 表示選擇該按鈕，為 false 表示取消對該按鈕的選擇。

setPressed

public void setPressed(boolean b)

將按鈕設置為按下或未被按下。

指定者：

介面 ButtonModel 中的 setPressed

參數：

b - 是否應該按下該按鈕

另請參見：

ButtonModel.isPressed()

setRollover

public void setRollover(boolean b)

設置或清除該按鈕的翻轉狀態

指定者：

介面 ButtonModel 中的 setRollover

參數：

b - 該按鈕是否處於翻轉狀態

另請參見：

ButtonModel.isRollover()

setMnemonic

public void setMnemonic(int key)

設置該按鈕的鍵盤助記符（快捷鍵或加速鍵）。

指定者：

介面 ButtonModel 中的 setMnemonic

參數：

key - 指示加速鍵的 int 值

getMnemonic

public int getMnemonic()

獲取該按鈕的鍵盤助記符。

指定者：

介面 ButtonModel 中的 getMnemonic

返回：

指示加速鍵的 int 值

另請參見：

ButtonModel.setMnemonic(int)

addChangeListener

public void addChangeListener(ChangeListener l)

向模型添加一個 ChangeListener。

指定者：

介面 ButtonModel 中的 addChangeListener

參數：

l - 要添加的偵聽器

removeChangeListener

public void removeChangeListener(ChangeListener l)

從模型中移除一個 ChangeListener。

指定者：

介面 ButtonModel 中的 removeChangeListener

參數：

l - 要移除的偵聽器

getChangeListeners

public ChangeListener[] getChangeListeners()

返回此 DefaultButtonModel 上所有已註冊的更改偵聽器組成的陣列。

返回：

此模型的所有 ChangeListener，如果當前沒有已註冊的更改偵聽器，則返回一個空陣列。

從以下版本開始：

1.4

另請參見：

addChangeListener(javax.swing.event.ChangeListener), removeChangeListener(javax.swing.event.ChangeListener)

fireStateChanged

protected void fireStateChanged()

通知所有對此事件型別的通知感興趣的已註冊偵聽器。以延遲方式創建事件實例。

另請參見：

EventListenerList

addActionListener

public void addActionListener(ActionListener l)

向模型添加一個 ActionListener。

指定者：

介面 ButtonModel 中的 addActionListener

參數：

l - 要添加的偵聽器

removeActionListener

public void removeActionListener(ActionListener l)

從模型中移除一個 ActionListener。

指定者：

介面 ButtonModel 中的 removeActionListener

參數：

l - 要移除的偵聽器

getActionListeners

public ActionListener[] getActionListeners()

返回此 DefaultButtonModel 上所有已註冊的操作偵聽器組成的陣列。

返回：

此模型的所有 ActionListener；如果當前沒有註冊任何操作偵聽器，則返回一個空陣列。

從以下版本開始：

1.4

另請參見：

addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener)

fireActionPerformed

protected void fireActionPerformed(ActionEvent e)

通知所有對此事件型別的通知感興趣的已註冊偵聽器。

參數：

e - 要傳遞給偵聽器的 ActionEvent

另請參見：

EventListenerList

addItemListener

public void addItemListener(ItemListener l)

向模型添加一個 ItemListener。

指定者：

介面 ItemSelectable 中的 addItemListener

指定者：

介面 ButtonModel 中的 addItemListener

參數：

l - 要添加的偵聽器

另請參見：

ItemEvent

removeItemListener

public void removeItemListener(ItemListener l)

從模型中移除一個 ItemListener。

指定者：

介面 ItemSelectable 中的 removeItemListener

指定者：

介面 ButtonModel 中的 removeItemListener

參數：

l - 要移除的偵聽器

另請參見：

ItemEvent

getItemListeners

public ItemListener[] getItemListeners()

返回此 DefaultButtonModel 上所有已註冊的項偵聽器組成的陣列。

返回：

此模型的所有 ItemListener，如果沒有當前已註冊的項偵聽器，則返回一個空陣列

從以下版本開始：

1.4

另請參見：

addItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener)

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)

通知所有對此事件型別的通知感興趣的已註冊偵聽器。

參數：

e - 要傳遞給偵聽器的 ItemEvent

另請參見：

EventListenerList

getListeners

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

返回目前已在此模型上註冊為 FooListener 的所有物件組成的陣列。FooListener 是用 addFooListener 方法註冊的。

可以使用 class 文字值來指定 listenerType 參數，如 FooListener.class。例如，可以使用下面的程式碼查詢 DefaultButtonModel 實例 m 的操作偵聽器：

ActionListener[] als = (ActionListener[])(m.getListeners(ActionListener.class));

如果不存在這樣的偵聽器，則此方法將返回一個空陣列。

參數：

listenerType - 請求的偵聽器型別；該參數應該指定一個從 java.util.EventListener 繼承的介面

返回：

在此模型上註冊為 FooListener 的所有物件組成的陣列，如果沒有添加這樣的偵聽器，則返回一個空陣列

拋出：

ClassCastException - 如果 listenerType 沒有指定實作 java.util.EventListener 的類別或介面

從以下版本開始：

1.3

另請參見：

getActionListeners(), getChangeListeners(), getItemListeners()

getSelectedObjects

public Object[] getSelectedObjects()

覆寫以返回 null。

指定者：

介面 ItemSelectable 中的 getSelectedObjects

setGroup

public void setGroup(ButtonGroup group)

標識該按鈕所屬的組，這是單選鈕所需要的，單選鈕在它們的組內相互排斥。

指定者：

介面 ButtonModel 中的 setGroup

參數：

group - 該按鈕所屬的 ButtonGroup

getGroup

public ButtonGroup getGroup()

返回該按鈕所屬的組。通常用於單選鈕，它們在其組中相互排斥。

返回：

該按鈕所屬的 ButtonGroup

從以下版本開始：

1.3