JavaTM 2 Platform
Standard Ed. 6

javax.swing
類別 AbstractButton

java.lang.Object
  繼承者 java.awt.Component
      繼承者 java.awt.Container
          繼承者 javax.swing.JComponent
              繼承者 javax.swing.AbstractButton
所有已實作的介面:
ImageObserver, ItemSelectable, MenuContainer, Serializable, SwingConstants
直接已知子類別:
JButton, JMenuItem, JToggleButton

public abstract class AbstractButton
extends JComponent
implements ItemSelectable, SwingConstants

定義按鈕和選單項的一般行為。

按鈕可以進行配置,以及通過 Action 進行某種程度的控制。使用帶有按鈕的 Action 具有除直接配置按鈕之外的許多優點。有關更多資訊,請參閱支持 Action 的 Swing 元件,在 The Java Tutorial 中的 How to Use Actions 一節中可以找到更多資訊。

有關更多資訊,請參閱 The Java Tutorial 中的 How to Use Buttons, Check Boxes, and Radio Buttons 一節。

警告:此類別的已序列化物件與以後的 Swing 版本不相容。當前序列化支持適用於短期存儲,或適用於在運行相同 Swing 版本的應用程序之間進行 RMI(Remote Method Invocation,遠端方法調用)。從 1.4 版本開始,已在 java.beans 套件中添加了支持所有 JavaBeansTM 長期存儲的功能。請參見 XMLEncoder


巢狀類別摘要
protected  class AbstractButton.AccessibleAbstractButton
          此類別實作對 AbstractButton 類別的可存取性支持。
protected  class AbstractButton.ButtonChangeListener
          將 ChangeListener 擴展為可序列化的。
 
從類別 javax.swing.JComponent 繼承的巢狀類別/介面
JComponent.AccessibleJComponent
 
從類別 java.awt.Container 繼承的巢狀類別/介面
Container.AccessibleAWTContainer
 
從類別 java.awt.Component 繼承的巢狀類別/介面
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
欄位摘要
protected  ActionListener actionListener
          按鈕模型的 ActionListener
static String BORDER_PAINTED_CHANGED_PROPERTY
          標識是否繪製邊框的更改。
protected  ChangeEvent changeEvent
          每個按鈕實例都只需要一個 ChangeEvent,因為事件的唯一狀態是源屬性。
protected  ChangeListener changeListener
          按鈕模型的 changeListener
static String CONTENT_AREA_FILLED_CHANGED_PROPERTY
          標識對按鈕繪製的內容區域的更改。
static String DISABLED_ICON_CHANGED_PROPERTY
          標識禁用按鈕時使用的圖標的更改。
static String DISABLED_SELECTED_ICON_CHANGED_PROPERTY
          標識禁用並選定按鈕時使用的圖標的更改。
static String FOCUS_PAINTED_CHANGED_PROPERTY
          標識是否在邊框擁有焦點時高亮顯示。
static String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY
          標識按鈕的水平對齊方式的更改。
static String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY
          標識按鈕的水平文本位置的更改。
static String ICON_CHANGED_PROPERTY
          標識對表示該按鈕的圖標的更改。
protected  ItemListener itemListener
          按鈕模型的 ItemListener
static String MARGIN_CHANGED_PROPERTY
          標識按鈕的邊界空白的更改。
static String MNEMONIC_CHANGED_PROPERTY
          標識按鈕的助記符中的更改。
protected  ButtonModel model
          確定按鈕狀態的資料模型。
static String MODEL_CHANGED_PROPERTY
          標識按鈕模型中的更改。
static String PRESSED_ICON_CHANGED_PROPERTY
          標識對按下按鈕時使用的圖標的更改。
static String ROLLOVER_ENABLED_CHANGED_PROPERTY
          標識從啟用翻轉到禁用翻轉或者從禁用翻轉到啟用翻轉的更改。
static String ROLLOVER_ICON_CHANGED_PROPERTY
          標識對鼠標移動到按鈕上時使用的圖標的更改。
static String ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY
          標識對鼠標移動到按鈕上並選定該按鈕時使用的圖標的更改。
static String SELECTED_ICON_CHANGED_PROPERTY
          標識對選定按鈕時使用的圖標的更改。
static String TEXT_CHANGED_PROPERTY
          標識按鈕的文本中的更改。
static String VERTICAL_ALIGNMENT_CHANGED_PROPERTY
          標識按鈕的垂直對齊方式的更改。
static String 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
 
建構子摘要
AbstractButton()
           
 
方法摘要
protected  void actionPropertyChanged(Action action, String propertyName)
          更新按鈕的狀態以回應相關的操作中的屬性更改。
 void addActionListener(ActionListener l)
          將一個 ActionListener 添加到按鈕中。
 void addChangeListener(ChangeListener l)
          向按鈕添加一個 ChangeListener
protected  void addImpl(Component comp, Object constraints, int index)
          將指定元件添加到此容器的指定索引所在的位置上,有關此方法的完整描述,請參閱 Container.addImpl(Component, Object, int)
 void addItemListener(ItemListener l)
          將一個 ItemListener 添加到 checkbox 中。
protected  int checkHorizontalKey(int key, String exception)
          驗證 key 參數是否為 horizontalAlignmenthorizontalTextPosition 屬性的合法值。
protected  int checkVerticalKey(int key, String exception)
          驗證 key 參數是否為垂直屬性的合法值。
protected  void configurePropertiesFromAction(Action a)
          在此按鈕上設置屬性以比對指定 Action 中的屬性。
protected  ActionListener createActionListener()
           
protected  PropertyChangeListener createActionPropertyChangeListener(Action a)
          創建並返回 PropertyChangeListener,它負責偵聽指定 Action 的更改以及更新適當的屬性。
protected  ChangeListener createChangeListener()
          想以不同的方式處理 ChangeEvent 的子類別可以覆寫此方法,以返回另一個 ChangeListener 實作。
protected  ItemListener createItemListener()
           
 void doClick()
          以程式方式執行“單擊”。
 void doClick(int pressTime)
          以程式方式執行“單擊”。
protected  void fireActionPerformed(ActionEvent event)
          通知所有需要此事件型別的通知的已註冊偵聽器。
protected  void fireItemStateChanged(ItemEvent event)
          通知所有需要此事件型別的通知的已註冊偵聽器。
protected  void fireStateChanged()
          通知所有需要此事件型別的通知的已註冊偵聽器。
 Action getAction()
          返回當前為此 ActionEvent 源設置的 Action,如果沒有設置任何 Action,則返回 null
 String getActionCommand()
          返回此按鈕的動作命令。
 ActionListener[] getActionListeners()
          返回使用 addActionListener() 添加到此 AbstractButton 的所有 ActionListener 組成的陣列。
 ChangeListener[] getChangeListeners()
          返回使用 addChangeListener() 添加到此 AbstractButton 中的所有 ChangeListener 組成的陣列。
 Icon getDisabledIcon()
          返回禁用按鈕時按鈕使用的圖標。
 Icon getDisabledSelectedIcon()
          返回禁用並選擇按鈕時按鈕使用的圖標。
 int getDisplayedMnemonicIndex()
          以索引形式返回字元,它表示助記符字元,外觀應該對其提供裝飾。
 boolean getHideActionText()
          返回 hideActionText 屬性的值,該屬性確定按鈕是否顯示 Action 的文本。
 int getHorizontalAlignment()
          返回圖標和文本的水平對齊方式。
 int getHorizontalTextPosition()
          返回文本相對於圖標的水平位置。
 Icon getIcon()
          返回預設圖標。
 int getIconTextGap()
          返回此按鈕中顯示的文本與圖標之間的間隔量。
 ItemListener[] getItemListeners()
          返回使用 addItemListener() 添加到此 AbstractButton 中的所有 ItemListener 組成的陣列。
 String getLabel()
          已過時。 - 由 getText 取代
 Insets getMargin()
          返回按鈕邊框和標籤之間的空白。
 int getMnemonic()
          返回當前模型中的鍵盤助記符。
 ButtonModel getModel()
          返回此按鈕表示的模型。
 long getMultiClickThreshhold()
          獲取對按鈕按下鼠標到產生相應動作事件所需的時間量(以毫秒為單位)。
 Icon getPressedIcon()
          返回按鈕的按下圖標。
 Icon getRolloverIcon()
          返回按鈕的翻轉圖標。
 Icon getRolloverSelectedIcon()
          返回按鈕的翻轉選定圖標。
 Icon getSelectedIcon()
          返回按鈕的選擇圖標。
 Object[] getSelectedObjects()
          返回包含標籤的陣列(長度為 1),如果沒有選擇按鈕,則返回 null
 String getText()
          返回按鈕的文本。
 ButtonUI getUI()
          返回呈現此元件的 L&F 物件。
 int getVerticalAlignment()
          返回文本和圖標的垂直對齊方式。
 int getVerticalTextPosition()
          返回文本相對於圖標的垂直位置。
 boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
          覆寫的此方法在當前 IconImage 不等於傳入的 Image img 時返回 false。
protected  void init(String text, Icon icon)
           
 boolean isBorderPainted()
          獲取 borderPainted 屬性。
 boolean isContentAreaFilled()
          獲取 contentAreaFilled 屬性。
 boolean isFocusPainted()
          獲取 paintFocus 屬性。
 boolean isRolloverEnabled()
          獲取 rolloverEnabled 屬性。
 boolean isSelected()
          返回按鈕的狀態。
protected  void paintBorder(Graphics g)
          如果 BorderPainted 屬性為 true 並且按鈕有邊框,則繪製該按鈕邊框。
protected  String paramString()
          返回此 AbstractButton 的字元串表示形式。
 void removeActionListener(ActionListener l)
          從按鈕中移除一個 ActionListener
 void removeChangeListener(ChangeListener l)
          從按鈕中移除一個 ChangeListener。
 void removeItemListener(ItemListener l)
          從按鈕中移除一個 ItemListener
 void removeNotify()
          通知此元件它不再有父元件。
 void setAction(Action a)
          設置 Action
 void setActionCommand(String actionCommand)
          設置此按鈕的動作命令。
 void setBorderPainted(boolean b)
          設置 borderPainted 屬性。
 void setContentAreaFilled(boolean b)
          設置 contentAreaFilled 屬性。
 void setDisabledIcon(Icon disabledIcon)
          設置按鈕的禁用圖標。
 void setDisabledSelectedIcon(Icon disabledSelectedIcon)
          設置按鈕的禁用選擇圖標。
 void setDisplayedMnemonicIndex(int index)
          提供關於應該裝飾文本中哪一個字元來表示助記符的外觀提示。
 void setEnabled(boolean b)
          啟用(或禁用)按鈕。
 void setFocusPainted(boolean b)
          設置 paintFocus 屬性,對於要繪製的焦點狀態,該屬性必須為 true
 void setHideActionText(boolean hideActionText)
          設置 hideActionText 屬性,該屬性確定按鈕是否顯示 Action 的文本。
 void setHorizontalAlignment(int alignment)
          設置圖標和文本的水平對齊方式。
 void setHorizontalTextPosition(int textPosition)
          設置文本相對於圖標的水平位置。
 void setIcon(Icon defaultIcon)
          設置按鈕的預設圖標。
 void setIconTextGap(int iconTextGap)
          如果圖標和文本的屬性都已設置,則此屬性定義圖標和文本之間的間隔。
 void setLabel(String label)
          已過時。 - 由 setText(text) 取代
 void setLayout(LayoutManager mgr)
          為此容器設置佈局管理器,有關此方法的完整描述,請參閱 Container.setLayout(LayoutManager)
 void setMargin(Insets m)
          設置按鈕邊框和標籤之間的空白。
 void setMnemonic(char mnemonic)
          此方法現在已廢棄,請使用 setMnemonic(int) 來設置按鈕的助記符。
 void setMnemonic(int mnemonic)
          設置當前模型上的鍵盤助記符。
 void setModel(ButtonModel newModel)
          設置此按鈕表示的模型。
 void setMultiClickThreshhold(long threshhold)
          設置對按鈕按下鼠標到產生相應動作事件所需的時間量(以毫秒為單位)。
 void setPressedIcon(Icon pressedIcon)
          設置按鈕的按下圖標。
 void setRolloverEnabled(boolean b)
          設置 rolloverEnabled 屬性,若需要翻轉效果,該屬性必須為 true
 void setRolloverIcon(Icon rolloverIcon)
          設置按鈕的翻轉圖標。
 void setRolloverSelectedIcon(Icon rolloverSelectedIcon)
          設置按鈕的翻轉選擇圖標。
 void setSelected(boolean b)
          設置按鈕的狀態。
 void setSelectedIcon(Icon selectedIcon)
          設置按鈕的選擇圖標。
 void setText(String text)
          設置按鈕的文本。
 void setUI(ButtonUI ui)
          設置呈現此元件的 L&F 物件。
 void setVerticalAlignment(int alignment)
          設置圖標和文本的垂直對齊方式。
 void setVerticalTextPosition(int textPosition)
          設置文本相對於圖標的垂直位置。
 void updateUI()
          將 UI 屬性重置為當前外觀中的一個值。
 
從類別 javax.swing.JComponent 繼承的方法
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
從類別 java.awt.Container 繼承的方法
add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, 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, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, 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, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, 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
 

欄位詳細資訊

MODEL_CHANGED_PROPERTY

public static final String MODEL_CHANGED_PROPERTY
標識按鈕模型中的更改。

另請參見:
常數欄位值

TEXT_CHANGED_PROPERTY

public static final String TEXT_CHANGED_PROPERTY
標識按鈕的文本中的更改。

另請參見:
常數欄位值

MNEMONIC_CHANGED_PROPERTY

public static final String MNEMONIC_CHANGED_PROPERTY
標識按鈕的助記符中的更改。

另請參見:
常數欄位值

MARGIN_CHANGED_PROPERTY

public static final String MARGIN_CHANGED_PROPERTY
標識按鈕的邊界空白的更改。

另請參見:
常數欄位值

VERTICAL_ALIGNMENT_CHANGED_PROPERTY

public static final String VERTICAL_ALIGNMENT_CHANGED_PROPERTY
標識按鈕的垂直對齊方式的更改。

另請參見:
常數欄位值

HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY

public static final String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY
標識按鈕的水平對齊方式的更改。

另請參見:
常數欄位值

VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

public static final String VERTICAL_TEXT_POSITION_CHANGED_PROPERTY
標識按鈕的垂直文本位置的更改。

另請參見:
常數欄位值

HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY

public static final String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY
標識按鈕的水平文本位置的更改。

另請參見:
常數欄位值

BORDER_PAINTED_CHANGED_PROPERTY

public static final String BORDER_PAINTED_CHANGED_PROPERTY
標識是否繪製邊框的更改。

另請參見:
常數欄位值

FOCUS_PAINTED_CHANGED_PROPERTY

public static final String FOCUS_PAINTED_CHANGED_PROPERTY
標識是否在邊框擁有焦點時高亮顯示。

另請參見:
常數欄位值

ROLLOVER_ENABLED_CHANGED_PROPERTY

public static final String ROLLOVER_ENABLED_CHANGED_PROPERTY
標識從啟用翻轉到禁用翻轉或者從禁用翻轉到啟用翻轉的更改。

另請參見:
常數欄位值

CONTENT_AREA_FILLED_CHANGED_PROPERTY

public static final String CONTENT_AREA_FILLED_CHANGED_PROPERTY
標識對按鈕繪製的內容區域的更改。

另請參見:
常數欄位值

ICON_CHANGED_PROPERTY

public static final String ICON_CHANGED_PROPERTY
標識對表示該按鈕的圖標的更改。

另請參見:
常數欄位值

PRESSED_ICON_CHANGED_PROPERTY

public static final String PRESSED_ICON_CHANGED_PROPERTY
標識對按下按鈕時使用的圖標的更改。

另請參見:
常數欄位值

SELECTED_ICON_CHANGED_PROPERTY

public static final String SELECTED_ICON_CHANGED_PROPERTY
標識對選定按鈕時使用的圖標的更改。

另請參見:
常數欄位值

ROLLOVER_ICON_CHANGED_PROPERTY

public static final String ROLLOVER_ICON_CHANGED_PROPERTY
標識對鼠標移動到按鈕上時使用的圖標的更改。

另請參見:
常數欄位值

ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY

public static final String ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY
標識對鼠標移動到按鈕上並選定該按鈕時使用的圖標的更改。

另請參見:
常數欄位值

DISABLED_ICON_CHANGED_PROPERTY

public static final String DISABLED_ICON_CHANGED_PROPERTY
標識禁用按鈕時使用的圖標的更改。

另請參見:
常數欄位值

DISABLED_SELECTED_ICON_CHANGED_PROPERTY

public static final String DISABLED_SELECTED_ICON_CHANGED_PROPERTY
標識禁用並選定按鈕時使用的圖標的更改。

另請參見:
常數欄位值

model

protected ButtonModel model
確定按鈕狀態的資料模型。


changeListener

protected ChangeListener changeListener
按鈕模型的 changeListener


actionListener

protected ActionListener actionListener
按鈕模型的 ActionListener


itemListener

protected ItemListener itemListener
按鈕模型的 ItemListener


changeEvent

protected transient ChangeEvent changeEvent
每個按鈕實例都只需要一個 ChangeEvent,因為事件的唯一狀態是源屬性。所產生的事件源總是 "this"。

建構子詳細資訊

AbstractButton

public AbstractButton()
方法詳細資訊

setHideActionText

public void setHideActionText(boolean hideActionText)
設置 hideActionText 屬性,該屬性確定按鈕是否顯示 Action 的文本。只有在按鈕上已安裝了 Action 時,此方法才有用。

參數:
hideActionText - 如果按鈕的 text 屬性不應該反映 Action 的文本,則該參數為 true;預設情況下為 false
從以下版本開始:
1.6
另請參見:
支持 Action 的 Swing 元件

getHideActionText

public boolean getHideActionText()
返回 hideActionText 屬性的值,該屬性確定按鈕是否顯示 Action 的文本。只有在按鈕上已安裝了 Action 時,此方法才有用。

返回:
如果按鈕的 text 屬性不應該反映 Action 的文本,則返回 true;預設情況下返回 false
從以下版本開始:
1.6

getText

public String getText()
返回按鈕的文本。

返回:
按鈕的文本
另請參見:
setText(java.lang.String)

setText

public void setText(String text)
設置按鈕的文本。

參數:
text - 用於設置文本的字元串
另請參見:
getText()

isSelected

public boolean isSelected()
返回按鈕的狀態。如果選定了切換按鈕,則返回 true,否則返回 false。

返回:
如果選定了切換按鈕,則返回 true,否則返回 false

setSelected

public void setSelected(boolean b)
設置按鈕的狀態。注意,此方法不會觸發 actionEvent。調用 doClick 以執行程序上的動作更改。

參數:
b - 如果選擇了按鈕,則該參數為 true,否則為 false

doClick

public void doClick()
以程式方式執行“單擊”。此方法的效果等同於使用者按下並隨後釋放按鈕。


doClick

public void doClick(int pressTime)
以程式方式執行“單擊”。此方法的效果等同於使用者按下並隨後釋放按鈕。按鈕在虛擬“按下”狀態下停留 pressTime 毫秒的時間。

參數:
pressTime - “按下”按鈕的時間,以毫秒為單位

setMargin

public void setMargin(Insets m)
設置按鈕邊框和標籤之間的空白。將該空白設置為 null 會造成按鈕使用預設空白。按鈕的預設 Border 物件將使用該值來創建適當的空白。不過,如果在按鈕上設置非預設邊框,則由 Border 物件負責創建適當的空白(否則此屬性將被忽略)。

參數:
m - 邊框和標籤之間的間隔

getMargin

public Insets getMargin()
返回按鈕邊框和標籤之間的空白。

返回:
一個指定按鈕邊框和標籤之間的空白的 Insets 物件
另請參見:
setMargin(java.awt.Insets)

getIcon

public Icon getIcon()
返回預設圖標。

返回:
預設 Icon
另請參見:
setIcon(javax.swing.Icon)

setIcon

public void setIcon(Icon defaultIcon)
設置按鈕的預設圖標。如果沒有顯式地設置按下的圖標,則此圖標還被用作“按下”和“禁用”圖標。

參數:
defaultIcon - 用作預設圖像的圖標
另請參見:
getIcon(), setPressedIcon(javax.swing.Icon)

getPressedIcon

public Icon getPressedIcon()
返回按鈕的按下圖標。

返回:
pressedIcon 屬性
另請參見:
setPressedIcon(javax.swing.Icon)

setPressedIcon

public void setPressedIcon(Icon pressedIcon)
設置按鈕的按下圖標。

參數:
pressedIcon - 用作“按下”圖像的圖標
另請參見:
getPressedIcon()

getSelectedIcon

public Icon getSelectedIcon()
返回按鈕的選擇圖標。

返回:
selectedIcon 屬性
另請參見:
setSelectedIcon(javax.swing.Icon)

setSelectedIcon

public void setSelectedIcon(Icon selectedIcon)
設置按鈕的選擇圖標。

參數:
selectedIcon - 用作“選擇”圖像的圖標
另請參見:
getSelectedIcon()

getRolloverIcon

public Icon getRolloverIcon()
返回按鈕的翻轉圖標。

返回:
rolloverIcon 屬性
另請參見:
setRolloverIcon(javax.swing.Icon)

setRolloverIcon

public void setRolloverIcon(Icon rolloverIcon)
設置按鈕的翻轉圖標。

參數:
rolloverIcon - 用作“翻轉”圖像的圖標
另請參見:
getRolloverIcon()

getRolloverSelectedIcon

public Icon getRolloverSelectedIcon()
返回按鈕的翻轉選定圖標。

返回:
rolloverSelectedIcon 屬性
另請參見:
setRolloverSelectedIcon(javax.swing.Icon)

setRolloverSelectedIcon

public void setRolloverSelectedIcon(Icon rolloverSelectedIcon)
設置按鈕的翻轉選擇圖標。

參數:
rolloverSelectedIcon - 用作“選擇翻轉”圖像的圖標
另請參見:
getRolloverSelectedIcon()

getDisabledIcon

public Icon getDisabledIcon()
返回禁用按鈕時按鈕使用的圖標。如果沒有設置禁用圖標,則此方法將調用轉發給外觀,以建構適當的禁用 Icon。

一些外觀上可能沒有呈現禁用圖標,在這種情況下,它們將忽略此圖標。

返回:
disabledIcon 屬性
另請參見:
getPressedIcon(), setDisabledIcon(javax.swing.Icon), LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon)

setDisabledIcon

public void setDisabledIcon(Icon disabledIcon)
設置按鈕的禁用圖標。

參數:
disabledIcon - 用作禁用圖像的圖標
另請參見:
getDisabledIcon()

getDisabledSelectedIcon

public Icon getDisabledSelectedIcon()
返回禁用並選擇按鈕時按鈕使用的圖標。如果沒有設置禁用選擇圖標,則將調用轉發給 LookAndFeel,以從選擇圖標中(如果已設置)建構適當的禁用圖標;否則將調用轉發給 getDisabledIcon()

一些外觀上可能沒有呈現禁用選擇 Icon,在這種情況下,它們將忽略此圖標。

返回:
disabledSelectedIcon 屬性
另請參見:
getDisabledIcon(), setDisabledSelectedIcon(javax.swing.Icon), LookAndFeel.getDisabledSelectedIcon(javax.swing.JComponent, javax.swing.Icon)

setDisabledSelectedIcon

public void setDisabledSelectedIcon(Icon disabledSelectedIcon)
設置按鈕的禁用選擇圖標。

參數:
disabledSelectedIcon - 用作禁用選擇圖像的圖標
另請參見:
getDisabledSelectedIcon()

getVerticalAlignment

public int getVerticalAlignment()
返回文本和圖標的垂直對齊方式。

返回:
verticalAlignment 屬性,它是以下值之一:
  • SwingConstants.CENTER(預設值)
  • SwingConstants.TOP
  • SwingConstants.BOTTOM

setVerticalAlignment

public void setVerticalAlignment(int alignment)
設置圖標和文本的垂直對齊方式。

參數:
alignment - 它是以下值之一:
  • SwingConstants.CENTER(預設值)
  • SwingConstants.TOP
  • SwingConstants.BOTTOM
拋出:
IllegalArgumentException - 如果對齊方式不是上面列出的合法值之一

getHorizontalAlignment

public int getHorizontalAlignment()
返回圖標和文本的水平對齊方式。AbstractButton 的預設對齊方式為 SwingConstants.CENTER,但子類別(如 JCheckBox)可以使用不同的預設對齊方式。

返回:
horizontalAlignment 屬性,它是以下值之一:
  • SwingConstants.RIGHT
  • SwingConstants.LEFT
  • SwingConstants.CENTER
  • SwingConstants.LEADING
  • SwingConstants.TRAILING

setHorizontalAlignment

public void setHorizontalAlignment(int alignment)
設置圖標和文本的水平對齊方式。AbstractButton 的預設對齊方式為 SwingConstants.CENTER,但子類別(如 JCheckBox)可以使用不同的預設對齊方式。

參數:
alignment - 對齊方式的值,它是以下值之一:
  • SwingConstants.RIGHT
  • SwingConstants.LEFT
  • SwingConstants.CENTER
  • SwingConstants.LEADING
  • SwingConstants.TRAILING
拋出:
IllegalArgumentException - 如果對齊方式不是有效值之一

getVerticalTextPosition

public int getVerticalTextPosition()
返回文本相對於圖標的垂直位置。

返回:
verticalTextPosition 屬性,它是以下值之一:
  • SwingConstants.CENTER(預設值)
  • SwingConstants.TOP
  • SwingConstants.BOTTOM

setVerticalTextPosition

public void setVerticalTextPosition(int textPosition)
設置文本相對於圖標的垂直位置。

參數:
textPosition - 它是以下值之一:
  • SwingConstants.CENTER(預設值)
  • SwingConstants.TOP
  • SwingConstants.BOTTOM

getHorizontalTextPosition

public int getHorizontalTextPosition()
返回文本相對於圖標的水平位置。

返回:
horizontalTextPosition 屬性,它是以下值之一:
  • SwingConstants.RIGHT
  • SwingConstants.LEFT
  • SwingConstants.CENTER
  • SwingConstants.LEADING
  • SwingConstants.TRAILING(預設值)

setHorizontalTextPosition

public void setHorizontalTextPosition(int textPosition)
設置文本相對於圖標的水平位置。

參數:
textPosition - 它是以下值之一:
  • SwingConstants.RIGHT
  • SwingConstants.LEFT
  • SwingConstants.CENTER
  • SwingConstants.LEADING
  • SwingConstants.TRAILING(預設值)
拋出:
IllegalArgumentException - 如果 textPosition 不是上面列出的合法值之一

getIconTextGap

public int getIconTextGap()
返回此按鈕中顯示的文本與圖標之間的間隔量。

返回:
等於文本與圖標之間的像素數的 int 值。
從以下版本開始:
1.4
另請參見:
setIconTextGap(int)

setIconTextGap

public void setIconTextGap(int iconTextGap)
如果圖標和文本的屬性都已設置,則此屬性定義圖標和文本之間的間隔。

此屬性的預設值為 4 個像素。

這是一個 JavaBeans 綁定屬性。

從以下版本開始:
1.4
另請參見:
getIconTextGap()

checkHorizontalKey

protected int checkHorizontalKey(int key,
                                 String exception)
驗證 key 參數是否為 horizontalAlignmenthorizontalTextPosition 屬性的合法值。有效值有:

參數:
key - 要檢查的屬性值
exception - IllegalArgumentException 中要使用的訊息,無效值時拋出
拋出:
IllegalArgumentException - 如果 key 不是上面列出的合法值之一
另請參見:
setHorizontalTextPosition(int), setHorizontalAlignment(int)

checkVerticalKey

protected int checkVerticalKey(int key,
                               String exception)
驗證 key 參數是否為垂直屬性的合法值。有效值有:

參數:
key - 要檢查的屬性值
exception - IllegalArgumentException 中要使用的訊息,無效值時拋出
拋出:
IllegalArgumentException - 如果 key 不是上面列出的合法值之一

removeNotify

public void removeNotify()
通知此元件它不再有父元件。調用此方法時,移除父元件鏈中所有已設置的 KeyboardAction

覆寫:
類別 JComponent 中的 removeNotify
從以下版本開始:
1.6
另請參見:
JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

setActionCommand

public void setActionCommand(String actionCommand)
設置此按鈕的動作命令。

參數:
actionCommand - 此按鈕的動作命令

getActionCommand

public String getActionCommand()
返回此按鈕的動作命令。

返回:
此按鈕的動作命令

setAction

public void setAction(Action a)
設置 Action。新 Action 將替換所有以前設置的 Action,但不影響單獨使用 addActionListener 添加的 ActionListener。如果 Action 已經是按鈕的已註冊 ActionListener,則它不需要重新註冊。

設置 Action 導致支持 Action 的 Swing 元件中描述的所有屬性立即更改。隨後,按鈕的屬性根據 Action 的屬性的更改進行自動更新。

此方法可以使用三個其他方法設置並說明追蹤 Action 的屬性值。它使用 configurePropertiesFromAction 方法可立即更改按鈕的屬性。要追蹤 Action 的屬性值中的更改,此方法應註冊 createActionPropertyChangeListener 返回的 PropertyChangeListenerAction 中的屬性更改時,預設 PropertyChangeListener 調用 actionPropertyChanged 方法。

參數:
a - AbstractButtonAction,或為 null
從以下版本開始:
1.3
另請參見:
Action, getAction(), configurePropertiesFromAction(javax.swing.Action), createActionPropertyChangeListener(javax.swing.Action), actionPropertyChanged(javax.swing.Action, java.lang.String)

getAction

public Action getAction()
返回當前為此 ActionEvent 源設置的 Action,如果沒有設置任何 Action,則返回 null

返回:
ActionEvent 源的 Action,或 null
從以下版本開始:
1.3
另請參見:
Action, setAction(javax.swing.Action)

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)
在此按鈕上設置屬性以比對指定 Action 中的屬性。有關關於設置了哪些屬性的更多資訊,請參閱支持 Action 的 Swing 元件

參數:
a - 從中獲取屬性的 Action,或為 null
從以下版本開始:
1.3
另請參見:
Action, setAction(javax.swing.Action)

actionPropertyChanged

protected void actionPropertyChanged(Action action,
                                     String propertyName)
更新按鈕的狀態以回應相關的操作中的屬性更改。從 createActionPropertyChangeListener 返回的 PropertyChangeListener 中調用此方法。子類別通常不需要調用此方法。支持其他 Action 屬性的子類別應該覆寫此方法以及 configurePropertiesFromAction

有關此方法設置的屬性的列表,請參閱支持 Action 的 Swing 元件處的表。

參數:
action - 與此按鈕關聯的 Action
propertyName - 已更改屬性的名稱
從以下版本開始:
1.6
另請參見:
Action, configurePropertiesFromAction(javax.swing.Action)

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)
創建並返回 PropertyChangeListener,它負責偵聽指定 Action 的更改以及更新適當的屬性。

警告:如果為此類別創建子類別,則不要創建匿名內部類別。否則,按鈕的生命週期將依賴於 Action 的生命週期。

參數:
a - 按鈕的操作
從以下版本開始:
1.3
另請參見:
Actions, Action, setAction(javax.swing.Action)

isBorderPainted

public boolean isBorderPainted()
獲取 borderPainted 屬性。

返回:
borderPainted 屬性的值
另請參見:
setBorderPainted(boolean)

setBorderPainted

public void setBorderPainted(boolean b)
設置 borderPainted 屬性。如果該屬性為 true 並且按鈕有邊框,則繪製該邊框。borderPainted 屬性的預設值為 true

參數:
b - 如果為 true 並且邊框屬性不為 null,則繪製該邊框
另請參見:
isBorderPainted()

paintBorder

protected void paintBorder(Graphics g)
如果 BorderPainted 屬性為 true 並且按鈕有邊框,則繪製該按鈕邊框。

覆寫:
類別 JComponent 中的 paintBorder
參數:
g - 在其中進行繪製的 Graphics 環境
另請參見:
JComponent.paint(java.awt.Graphics), JComponent.setBorder(javax.swing.border.Border)

isFocusPainted

public boolean isFocusPainted()
獲取 paintFocus 屬性。

返回:
paintFocus 屬性
另請參見:
setFocusPainted(boolean)

setFocusPainted

public void setFocusPainted(boolean b)
設置 paintFocus 屬性,對於要繪製的焦點狀態,該屬性必須為 truepaintFocus 屬性的預設值為 true。一些外觀沒有繪製焦點狀態;它們將忽略此屬性。

參數:
b - 如果為 true,則應繪製焦點狀態
另請參見:
isFocusPainted()

isContentAreaFilled

public boolean isContentAreaFilled()
獲取 contentAreaFilled 屬性。

返回:
contentAreaFilled 屬性
另請參見:
setContentAreaFilled(boolean)

setContentAreaFilled

public void setContentAreaFilled(boolean b)
設置 contentAreaFilled 屬性。如果該屬性為 true,則按鈕將繪製內容區域。如果希望有一個透明的按鈕,比如只是一個圖標的按鈕,那麼應該將此屬性設置為 false。不要調用 setOpaque(false)contentAreaFilled 屬性的預設值為 true

此方法可能造成元件的不透明屬性發生更改。

調用此方法的具體行為在各個元件和各個 L&F 之間是各不相同的。

參數:
b - 如果為 true,則應該填充內容;如果為 false,則不填充內容區域
另請參見:
isContentAreaFilled(), JComponent.setOpaque(boolean)

isRolloverEnabled

public boolean isRolloverEnabled()
獲取 rolloverEnabled 屬性。

返回:
rolloverEnabled 屬性的值
另請參見:
setRolloverEnabled(boolean)

setRolloverEnabled

public void setRolloverEnabled(boolean b)
設置 rolloverEnabled 屬性,若需要翻轉效果,該屬性必須為 truerolloverEnabled 屬性的預設值為 false。一些外觀也許不實作翻轉效果;它們將忽略此屬性。

參數:
b - 如果為 true,則應繪製翻轉效果
另請參見:
isRolloverEnabled()

getMnemonic

public int getMnemonic()
返回當前模型中的鍵盤助記符。

返回:
模型中的鍵盤助記符

setMnemonic

public void setMnemonic(int mnemonic)
設置當前模型上的鍵盤助記符。助記符是某種鍵,它與外觀的無鼠標修飾符(通常是 Alt)組合時(如果焦點包含在此按鈕祖先視窗中的某個地方)將啟動此按鈕。

一個助記符必須對應鍵盤上的一個鍵,並且應該使用 java.awt.event.KeyEvent 中定義的 VK_XXX 鍵程式碼之一指定。助記符是不區分大小寫的,所以具有相應鍵程式碼的鍵事件將造成按鈕被啟動,不管是否按下 Shift 修飾符。

如果在按鈕的標籤字元串中發現由助記符定義的字元,則第一個出現的助記符將是帶下劃線的,以向使用者指示該助記符。

參數:
mnemonic - 表示助記符的鍵程式碼
另請參見:
KeyEvent, setDisplayedMnemonicIndex(int)

setMnemonic

public void setMnemonic(char mnemonic)
此方法現在已廢棄,請使用 setMnemonic(int) 來設置按鈕的助記符。此方法僅設計用於處理 'a' 到 'z' 或 'A' 到 'Z'之間的字元值。

參數:
mnemonic - 指定助記符值的字元
另請參見:
setMnemonic(int)

setDisplayedMnemonicIndex

public void setDisplayedMnemonicIndex(int index)
                               throws IllegalArgumentException
提供關於應該裝飾文本中哪一個字元來表示助記符的外觀提示。並不是所有的外觀都能支持此方法。值 -1 指示沒有助記符(助記符字元沒有包含在字元串中),或者開發人員不希望顯示助記符。

與助記符相關的屬性發生更改時(比如助記符本身、文本……),此索引值也被更改。如果不希望預設字元帶下劃線,那麼只能不斷地調用此方法。例如,如果文本 'Save As' 帶有一個助記符 'a',您想裝飾 'A'(比如裝飾成 'Save As'),那麼您必須在調用 setMnemonic(KeyEvent.VK_A) 之後調用 setDisplayedMnemonicIndex(5)

參數:
index - String 中的索引,指示要加下劃線的字元
拋出:
IllegalArgumentException - 如果 index >= 文本的長度,或者 < -1,則拋出該異常
從以下版本開始:
1.4
另請參見:
getDisplayedMnemonicIndex()

getDisplayedMnemonicIndex

public int getDisplayedMnemonicIndex()
以索引形式返回字元,它表示助記符字元,外觀應該對其提供裝飾。

返回:
表示助記符字元的索引
從以下版本開始:
1.4
另請參見:
setDisplayedMnemonicIndex(int)

setMultiClickThreshhold

public void setMultiClickThreshhold(long threshhold)
設置對按鈕按下鼠標到產生相應動作事件所需的時間量(以毫秒為單位)。在最初按下鼠標(並產生動作事件)之後,發生在小於 threshhold 的時間間隔中的所有後續鼠標按下事件都將被忽略,並且不產生相應的動作事件。預設情況下,threshhold 為 0,這意味著對於每個鼠標按下操作,都將觸發動作事件,無論單擊鼠標的速度有多快。在不需要此行為的按鈕中(比如對話框中的 "OK" 按鈕),應該將此 threshhold 設置為一個適當的正值。

參數:
threshhold - 按下鼠標到產生相應動作事件所需的時間量
拋出:
IllegalArgumentException - 如果 threshhold < 0
從以下版本開始:
1.4
另請參見:
getMultiClickThreshhold()

getMultiClickThreshhold

public long getMultiClickThreshhold()
獲取對按鈕按下鼠標到產生相應動作事件所需的時間量(以毫秒為單位)。

返回:
按下鼠標到產生相應動作事件所需的時間量
從以下版本開始:
1.4
另請參見:
setMultiClickThreshhold(long)

getModel

public ButtonModel getModel()
返回此按鈕表示的模型。

返回:
model 屬性
另請參見:
setModel(javax.swing.ButtonModel)

setModel

public void setModel(ButtonModel newModel)
設置此按鈕表示的模型。

參數:
newModel - 新的 ButtonModel
另請參見:
getModel()

getUI

public ButtonUI getUI()
返回呈現此元件的 L&F 物件。

返回:
ButtonUI 物件
另請參見:
setUI(javax.swing.plaf.ButtonUI)

setUI

public void setUI(ButtonUI ui)
設置呈現此元件的 L&F 物件。

參數:
ui - ButtonUI L&F 物件
另請參見:
getUI()

updateUI

public void updateUI()
將 UI 屬性重置為當前外觀中的一個值。AbstractButton 的子型別應該覆寫此方法來更新 UI。例如,JButton 可以執行以下操作:
      setUI((ButtonUI)UIManager.getUI(
          "ButtonUI", "javax.swing.plaf.basic.BasicButtonUI", this));
 

覆寫:
類別 JComponent 中的 updateUI
另請參見:
JComponent.setUI(javax.swing.plaf.ComponentUI), UIManager.getLookAndFeel(), UIManager.getUI(javax.swing.JComponent)

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)
將指定元件添加到此容器的指定索引所在的位置上,有關此方法的完整描述,請參閱 Container.addImpl(Component, Object, int)

覆寫:
類別 Container 中的 addImpl
參數:
comp - 要添加的元件
constraints - 表示此元件的佈局約束的物件
index - 容器列表中插入元件的位置,-1 表示添加到列表的末尾
拋出:
IllegalArgumentException - 如果 index 無效
IllegalArgumentException - 如果將容器的父容器添加到該容器自身中
IllegalArgumentException - 如果將一個視窗添加到容器中
從以下版本開始:
1.5
另請參見:
Container.add(Component), Container.add(Component, int), Container.add(Component, java.lang.Object), LayoutManager, LayoutManager2

setLayout

public void setLayout(LayoutManager mgr)
為此容器設置佈局管理器,有關此方法的完整描述,請參閱 Container.setLayout(LayoutManager)

覆寫:
類別 Container 中的 setLayout
參數:
mgr - 指定的佈局管理器
從以下版本開始:
1.5
另請參見:
Container.doLayout(), Container.getLayout()

addChangeListener

public void addChangeListener(ChangeListener l)
向按鈕添加一個 ChangeListener

參數:
l - 要添加的偵聽器

removeChangeListener

public void removeChangeListener(ChangeListener l)
從按鈕中移除一個 ChangeListener。

參數:
l - 要移除的偵聽器

getChangeListeners

public ChangeListener[] getChangeListeners()
返回使用 addChangeListener() 添加到此 AbstractButton 中的所有 ChangeListener 組成的陣列。

返回:
添加的所有 ChangeListener,如果沒有添加偵聽器,則返回一個空陣列
從以下版本開始:
1.4

fireStateChanged

protected void fireStateChanged()
通知所有需要此事件型別的通知的已註冊偵聽器。以延遲方式創建事件實例。

另請參見:
EventListenerList

addActionListener

public void addActionListener(ActionListener l)
將一個 ActionListener 添加到按鈕中。

參數:
l - 要添加的 ActionListener

removeActionListener

public void removeActionListener(ActionListener l)
從按鈕中移除一個 ActionListener。如果偵聽器是按鈕當前設置的 Action,則將 Action 設置為 null

參數:
l - 要移除的偵聽器

getActionListeners

public ActionListener[] getActionListeners()
返回使用 addActionListener() 添加到此 AbstractButton 的所有 ActionListener 組成的陣列。

返回:
添加的所有 ActionListener,如果沒有添加偵聽器,則返回一個空陣列
從以下版本開始:
1.4

createChangeListener

protected ChangeListener createChangeListener()
想以不同的方式處理 ChangeEvent 的子類別可以覆寫此方法,以返回另一個 ChangeListener 實作。

返回:
新的 ChangeListener

fireActionPerformed

protected void fireActionPerformed(ActionEvent event)
通知所有需要此事件型別的通知的已註冊偵聽器。使用 event 參數以延遲方式創建事件實例。

參數:
event - ActionEvent 物件
另請參見:
EventListenerList

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent event)
通知所有需要此事件型別的通知的已註冊偵聽器。使用 event 參數以延遲方式創建事件實例。

參數:
event - ItemEvent 物件
另請參見:
EventListenerList

createActionListener

protected ActionListener createActionListener()

createItemListener

protected ItemListener createItemListener()

setEnabled

public void setEnabled(boolean b)
啟用(或禁用)按鈕。

覆寫:
類別 JComponent 中的 setEnabled
參數:
b - true 表示啟用按鈕,否則為 false
另請參見:
Component.isEnabled(), Component.isLightweight()

getLabel

@Deprecated
public String getLabel()
已過時。 - 由 getText 取代

返回標籤文本。

返回:
包含標籤的 String

setLabel

@Deprecated
public void setLabel(String label)
已過時。 - 由 setText(text) 取代

設置標籤文本。

參數:
label - 套件含文本的 String

addItemListener

public void addItemListener(ItemListener l)
將一個 ItemListener 添加到 checkbox 中。

指定者:
介面 ItemSelectable 中的 addItemListener
參數:
l - 要添加的 ItemListener
另請參見:
ItemEvent

removeItemListener

public void removeItemListener(ItemListener l)
從按鈕中移除一個 ItemListener

指定者:
介面 ItemSelectable 中的 removeItemListener
參數:
l - 要移除的 ItemListener
另請參見:
ItemEvent

getItemListeners

public ItemListener[] getItemListeners()
返回使用 addItemListener() 添加到此 AbstractButton 中的所有 ItemListener 組成的陣列。

返回:
添加的所有 ItemListener,如果沒有添加偵聽器,則返回一個空陣列
從以下版本開始:
1.4

getSelectedObjects

public Object[] getSelectedObjects()
返回包含標籤的陣列(長度為 1),如果沒有選擇按鈕,則返回 null

指定者:
介面 ItemSelectable 中的 getSelectedObjects
返回:
包含 1 個 Object 的陣列:按鈕的文本,如果選擇該項;否則返回 null

init

protected void init(String text,
                    Icon icon)

imageUpdate

public boolean imageUpdate(Image img,
                           int infoflags,
                           int x,
                           int y,
                           int w,
                           int h)
覆寫的此方法在當前 IconImage 不等於傳入的 Image img 時返回 false。

指定者:
介面 ImageObserver 中的 imageUpdate
覆寫:
類別 Component 中的 imageUpdate
參數:
img - 要比較的 Image
infoflags - 更新圖像時用於重繪按鈕的標誌,它確定將繪製多大的區域
x - x 坐標
y - y 坐標
w - 寬度
h - 高度
返回:
如果 infoflags 表明已完全載入了圖像,則返回 false;否則返回 true
另請參見:
ImageObserver, Component.imageUpdate(java.awt.Image, int, int, int, int, int)

paramString

protected String paramString()
返回此 AbstractButton 的字元串表示形式。此方法僅在進行除錯的時候使用,對於各個實作,所返回字元串的內容和格式可能有所不同。返回的字元串可能為空,但不可能為 null

覆寫 paramString 來提供有關 JFC 元件的一些特定新方面的資訊。

覆寫:
類別 JComponent 中的 paramString
返回:
AbstractButton 的字元串表示形式

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only