|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.AbstractButton
public abstract class AbstractButton
定義按鈕和選單項的一般行為。
按鈕可以進行配置,以及通過 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 |
從類別 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 參數是否為 horizontalAlignment 和 horizontalTextPosition 屬性的合法值。 |
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)
覆寫的此方法在當前 Icon 的 Image 不等於傳入的 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 屬性重置為當前外觀中的一個值。 |
從類別 java.lang.Object 繼承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
欄位詳細資訊 |
---|
public static final String MODEL_CHANGED_PROPERTY
public static final String TEXT_CHANGED_PROPERTY
public static final String MNEMONIC_CHANGED_PROPERTY
public static final String MARGIN_CHANGED_PROPERTY
public static final String VERTICAL_ALIGNMENT_CHANGED_PROPERTY
public static final String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY
public static final String VERTICAL_TEXT_POSITION_CHANGED_PROPERTY
public static final String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY
public static final String BORDER_PAINTED_CHANGED_PROPERTY
public static final String FOCUS_PAINTED_CHANGED_PROPERTY
public static final String ROLLOVER_ENABLED_CHANGED_PROPERTY
public static final String CONTENT_AREA_FILLED_CHANGED_PROPERTY
public static final String ICON_CHANGED_PROPERTY
public static final String PRESSED_ICON_CHANGED_PROPERTY
public static final String SELECTED_ICON_CHANGED_PROPERTY
public static final String ROLLOVER_ICON_CHANGED_PROPERTY
public static final String ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY
public static final String DISABLED_ICON_CHANGED_PROPERTY
public static final String DISABLED_SELECTED_ICON_CHANGED_PROPERTY
protected ButtonModel model
protected ChangeListener changeListener
changeListener
。
protected ActionListener actionListener
ActionListener
。
protected ItemListener itemListener
ItemListener
。
protected transient ChangeEvent changeEvent
ChangeEvent
,因為事件的唯一狀態是源屬性。所產生的事件源總是 "this"。
建構子詳細資訊 |
---|
public AbstractButton()
方法詳細資訊 |
---|
public void setHideActionText(boolean hideActionText)
hideActionText
屬性,該屬性確定按鈕是否顯示 Action
的文本。只有在按鈕上已安裝了 Action
時,此方法才有用。
hideActionText
- 如果按鈕的 text
屬性不應該反映 Action
的文本,則該參數為 true
;預設情況下為 false
Action
的 Swing 元件public boolean getHideActionText()
hideActionText
屬性的值,該屬性確定按鈕是否顯示 Action
的文本。只有在按鈕上已安裝了 Action
時,此方法才有用。
text
屬性不應該反映 Action
的文本,則返回 true
;預設情況下返回 false
public String getText()
setText(java.lang.String)
public void setText(String text)
text
- 用於設置文本的字元串getText()
public boolean isSelected()
public void setSelected(boolean b)
actionEvent
。調用 doClick
以執行程序上的動作更改。
b
- 如果選擇了按鈕,則該參數為 true,否則為 falsepublic void doClick()
public void doClick(int pressTime)
pressTime
毫秒的時間。
pressTime
- “按下”按鈕的時間,以毫秒為單位public void setMargin(Insets m)
null
會造成按鈕使用預設空白。按鈕的預設 Border
物件將使用該值來創建適當的空白。不過,如果在按鈕上設置非預設邊框,則由 Border
物件負責創建適當的空白(否則此屬性將被忽略)。
m
- 邊框和標籤之間的間隔public Insets getMargin()
Insets
物件setMargin(java.awt.Insets)
public Icon getIcon()
Icon
setIcon(javax.swing.Icon)
public void setIcon(Icon defaultIcon)
defaultIcon
- 用作預設圖像的圖標getIcon()
,
setPressedIcon(javax.swing.Icon)
public Icon getPressedIcon()
pressedIcon
屬性setPressedIcon(javax.swing.Icon)
public void setPressedIcon(Icon pressedIcon)
pressedIcon
- 用作“按下”圖像的圖標getPressedIcon()
public Icon getSelectedIcon()
selectedIcon
屬性setSelectedIcon(javax.swing.Icon)
public void setSelectedIcon(Icon selectedIcon)
selectedIcon
- 用作“選擇”圖像的圖標getSelectedIcon()
public Icon getRolloverIcon()
rolloverIcon
屬性setRolloverIcon(javax.swing.Icon)
public void setRolloverIcon(Icon rolloverIcon)
rolloverIcon
- 用作“翻轉”圖像的圖標getRolloverIcon()
public Icon getRolloverSelectedIcon()
rolloverSelectedIcon
屬性setRolloverSelectedIcon(javax.swing.Icon)
public void setRolloverSelectedIcon(Icon rolloverSelectedIcon)
rolloverSelectedIcon
- 用作“選擇翻轉”圖像的圖標getRolloverSelectedIcon()
public Icon getDisabledIcon()
一些外觀上可能沒有呈現禁用圖標,在這種情況下,它們將忽略此圖標。
disabledIcon
屬性getPressedIcon()
,
setDisabledIcon(javax.swing.Icon)
,
LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon)
public void setDisabledIcon(Icon disabledIcon)
disabledIcon
- 用作禁用圖像的圖標getDisabledIcon()
public Icon getDisabledSelectedIcon()
getDisabledIcon()
。
一些外觀上可能沒有呈現禁用選擇 Icon,在這種情況下,它們將忽略此圖標。
disabledSelectedIcon
屬性getDisabledIcon()
,
setDisabledSelectedIcon(javax.swing.Icon)
,
LookAndFeel.getDisabledSelectedIcon(javax.swing.JComponent, javax.swing.Icon)
public void setDisabledSelectedIcon(Icon disabledSelectedIcon)
disabledSelectedIcon
- 用作禁用選擇圖像的圖標getDisabledSelectedIcon()
public int getVerticalAlignment()
verticalAlignment
屬性,它是以下值之一:
SwingConstants.CENTER
(預設值)
SwingConstants.TOP
SwingConstants.BOTTOM
public void setVerticalAlignment(int alignment)
alignment
- 它是以下值之一:
SwingConstants.CENTER
(預設值)
SwingConstants.TOP
SwingConstants.BOTTOM
IllegalArgumentException
- 如果對齊方式不是上面列出的合法值之一public int getHorizontalAlignment()
AbstractButton
的預設對齊方式為 SwingConstants.CENTER
,但子類別(如 JCheckBox
)可以使用不同的預設對齊方式。
horizontalAlignment
屬性,它是以下值之一:
SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING
public void setHorizontalAlignment(int alignment)
AbstractButton
的預設對齊方式為 SwingConstants.CENTER
,但子類別(如 JCheckBox
)可以使用不同的預設對齊方式。
alignment
- 對齊方式的值,它是以下值之一:
SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING
IllegalArgumentException
- 如果對齊方式不是有效值之一public int getVerticalTextPosition()
verticalTextPosition
屬性,它是以下值之一:
SwingConstants.CENTER
(預設值)
SwingConstants.TOP
SwingConstants.BOTTOM
public void setVerticalTextPosition(int textPosition)
textPosition
- 它是以下值之一:
SwingConstants.CENTER
(預設值)
SwingConstants.TOP
SwingConstants.BOTTOM
public int getHorizontalTextPosition()
horizontalTextPosition
屬性,它是以下值之一:
SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING
(預設值)
public void setHorizontalTextPosition(int textPosition)
textPosition
- 它是以下值之一:
SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING
(預設值)
IllegalArgumentException
- 如果 textPosition
不是上面列出的合法值之一public int getIconTextGap()
setIconTextGap(int)
public void setIconTextGap(int iconTextGap)
此屬性的預設值為 4 個像素。
這是一個 JavaBeans 綁定屬性。
getIconTextGap()
protected int checkHorizontalKey(int key, String exception)
key
參數是否為 horizontalAlignment
和 horizontalTextPosition
屬性的合法值。有效值有:
SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING
key
- 要檢查的屬性值exception
- IllegalArgumentException
中要使用的訊息,無效值時拋出
IllegalArgumentException
- 如果 key 不是上面列出的合法值之一setHorizontalTextPosition(int)
,
setHorizontalAlignment(int)
protected int checkVerticalKey(int key, String exception)
key
參數是否為垂直屬性的合法值。有效值有:
SwingConstants.CENTER
SwingConstants.TOP
SwingConstants.BOTTOM
key
- 要檢查的屬性值exception
- IllegalArgumentException
中要使用的訊息,無效值時拋出
IllegalArgumentException
- 如果 key 不是上面列出的合法值之一public void removeNotify()
KeyboardAction
。
JComponent
中的 removeNotify
JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)
public void setActionCommand(String actionCommand)
actionCommand
- 此按鈕的動作命令public String getActionCommand()
public void setAction(Action a)
Action
。新 Action
將替換所有以前設置的 Action
,但不影響單獨使用 addActionListener
添加的 ActionListener
。如果 Action
已經是按鈕的已註冊 ActionListener
,則它不需要重新註冊。
設置 Action
導致支持 Action
的 Swing 元件中描述的所有屬性立即更改。隨後,按鈕的屬性根據 Action
的屬性的更改進行自動更新。
此方法可以使用三個其他方法設置並說明追蹤 Action
的屬性值。它使用 configurePropertiesFromAction
方法可立即更改按鈕的屬性。要追蹤 Action
的屬性值中的更改,此方法應註冊 createActionPropertyChangeListener
返回的 PropertyChangeListener
。Action
中的屬性更改時,預設 PropertyChangeListener
調用 actionPropertyChanged
方法。
a
- AbstractButton
的 Action
,或為 null
Action
,
getAction()
,
configurePropertiesFromAction(javax.swing.Action)
,
createActionPropertyChangeListener(javax.swing.Action)
,
actionPropertyChanged(javax.swing.Action, java.lang.String)
public Action getAction()
ActionEvent
源設置的 Action
,如果沒有設置任何 Action
,則返回 null
。
ActionEvent
源的 Action
,或 null
Action
,
setAction(javax.swing.Action)
protected void configurePropertiesFromAction(Action a)
Action
中的屬性。有關關於設置了哪些屬性的更多資訊,請參閱支持 Action
的 Swing 元件。
a
- 從中獲取屬性的 Action
,或為 null
Action
,
setAction(javax.swing.Action)
protected void actionPropertyChanged(Action action, String propertyName)
createActionPropertyChangeListener
返回的 PropertyChangeListener
中調用此方法。子類別通常不需要調用此方法。支持其他 Action
屬性的子類別應該覆寫此方法以及 configurePropertiesFromAction
。
有關此方法設置的屬性的列表,請參閱支持 Action
的 Swing 元件處的表。
action
- 與此按鈕關聯的 Action
propertyName
- 已更改屬性的名稱Action
,
configurePropertiesFromAction(javax.swing.Action)
protected PropertyChangeListener createActionPropertyChangeListener(Action a)
PropertyChangeListener
,它負責偵聽指定 Action
的更改以及更新適當的屬性。
警告:如果為此類別創建子類別,則不要創建匿名內部類別。否則,按鈕的生命週期將依賴於 Action
的生命週期。
a
- 按鈕的操作Action
,
setAction(javax.swing.Action)
public boolean isBorderPainted()
borderPainted
屬性。
borderPainted
屬性的值setBorderPainted(boolean)
public void setBorderPainted(boolean b)
borderPainted
屬性。如果該屬性為 true
並且按鈕有邊框,則繪製該邊框。borderPainted
屬性的預設值為 true
。
b
- 如果為 true 並且邊框屬性不為 null
,則繪製該邊框isBorderPainted()
protected void paintBorder(Graphics g)
BorderPainted
屬性為 true 並且按鈕有邊框,則繪製該按鈕邊框。
JComponent
中的 paintBorder
g
- 在其中進行繪製的 Graphics
環境JComponent.paint(java.awt.Graphics)
,
JComponent.setBorder(javax.swing.border.Border)
public boolean isFocusPainted()
paintFocus
屬性。
paintFocus
屬性setFocusPainted(boolean)
public void setFocusPainted(boolean b)
paintFocus
屬性,對於要繪製的焦點狀態,該屬性必須為 true
。paintFocus
屬性的預設值為 true
。一些外觀沒有繪製焦點狀態;它們將忽略此屬性。
b
- 如果為 true
,則應繪製焦點狀態isFocusPainted()
public boolean isContentAreaFilled()
contentAreaFilled
屬性。
contentAreaFilled
屬性setContentAreaFilled(boolean)
public void setContentAreaFilled(boolean b)
contentAreaFilled
屬性。如果該屬性為 true
,則按鈕將繪製內容區域。如果希望有一個透明的按鈕,比如只是一個圖標的按鈕,那麼應該將此屬性設置為 false
。不要調用 setOpaque(false)
。contentAreaFilled
屬性的預設值為 true
。
此方法可能造成元件的不透明屬性發生更改。
調用此方法的具體行為在各個元件和各個 L&F 之間是各不相同的。
b
- 如果為 true,則應該填充內容;如果為 false,則不填充內容區域isContentAreaFilled()
,
JComponent.setOpaque(boolean)
public boolean isRolloverEnabled()
rolloverEnabled
屬性。
rolloverEnabled
屬性的值setRolloverEnabled(boolean)
public void setRolloverEnabled(boolean b)
rolloverEnabled
屬性,若需要翻轉效果,該屬性必須為 true
。rolloverEnabled
屬性的預設值為 false
。一些外觀也許不實作翻轉效果;它們將忽略此屬性。
b
- 如果為 true
,則應繪製翻轉效果isRolloverEnabled()
public int getMnemonic()
public void setMnemonic(int mnemonic)
一個助記符必須對應鍵盤上的一個鍵,並且應該使用 java.awt.event.KeyEvent
中定義的 VK_XXX
鍵程式碼之一指定。助記符是不區分大小寫的,所以具有相應鍵程式碼的鍵事件將造成按鈕被啟動,不管是否按下 Shift 修飾符。
如果在按鈕的標籤字元串中發現由助記符定義的字元,則第一個出現的助記符將是帶下劃線的,以向使用者指示該助記符。
mnemonic
- 表示助記符的鍵程式碼KeyEvent
,
setDisplayedMnemonicIndex(int)
public void setMnemonic(char mnemonic)
setMnemonic(int)
來設置按鈕的助記符。此方法僅設計用於處理 'a' 到 'z' 或 'A' 到 'Z'之間的字元值。
mnemonic
- 指定助記符值的字元setMnemonic(int)
public void setDisplayedMnemonicIndex(int index) throws IllegalArgumentException
與助記符相關的屬性發生更改時(比如助記符本身、文本……),此索引值也被更改。如果不希望預設字元帶下劃線,那麼只能不斷地調用此方法。例如,如果文本 'Save As' 帶有一個助記符 'a',您想裝飾 'A'(比如裝飾成 'Save As'),那麼您必須在調用 setMnemonic(KeyEvent.VK_A)
之後調用 setDisplayedMnemonicIndex(5)
。
index
- String 中的索引,指示要加下劃線的字元
IllegalArgumentException
- 如果 index
>= 文本的長度,或者 < -1,則拋出該異常getDisplayedMnemonicIndex()
public int getDisplayedMnemonicIndex()
setDisplayedMnemonicIndex(int)
public void setMultiClickThreshhold(long threshhold)
threshhold
- 按下鼠標到產生相應動作事件所需的時間量
IllegalArgumentException
- 如果 threshhold < 0getMultiClickThreshhold()
public long getMultiClickThreshhold()
setMultiClickThreshhold(long)
public ButtonModel getModel()
model
屬性setModel(javax.swing.ButtonModel)
public void setModel(ButtonModel newModel)
newModel
- 新的 ButtonModel
getModel()
public ButtonUI getUI()
setUI(javax.swing.plaf.ButtonUI)
public void setUI(ButtonUI ui)
ui
- ButtonUI
L&F 物件getUI()
public void updateUI()
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)
protected void addImpl(Component comp, Object constraints, int index)
Container.addImpl(Component, Object, int)
。
Container
中的 addImpl
comp
- 要添加的元件constraints
- 表示此元件的佈局約束的物件index
- 容器列表中插入元件的位置,-1
表示添加到列表的末尾
IllegalArgumentException
- 如果 index
無效
IllegalArgumentException
- 如果將容器的父容器添加到該容器自身中
IllegalArgumentException
- 如果將一個視窗添加到容器中Container.add(Component)
,
Container.add(Component, int)
,
Container.add(Component, java.lang.Object)
,
LayoutManager
,
LayoutManager2
public void setLayout(LayoutManager mgr)
Container.setLayout(LayoutManager)
。
Container
中的 setLayout
mgr
- 指定的佈局管理器Container.doLayout()
,
Container.getLayout()
public void addChangeListener(ChangeListener l)
ChangeListener
。
l
- 要添加的偵聽器public void removeChangeListener(ChangeListener l)
l
- 要移除的偵聽器public ChangeListener[] getChangeListeners()
ChangeListener
組成的陣列。
ChangeListener
,如果沒有添加偵聽器,則返回一個空陣列protected void fireStateChanged()
EventListenerList
public void addActionListener(ActionListener l)
ActionListener
添加到按鈕中。
l
- 要添加的 ActionListener
public void removeActionListener(ActionListener l)
ActionListener
。如果偵聽器是按鈕當前設置的 Action
,則將 Action
設置為 null
。
l
- 要移除的偵聽器public ActionListener[] getActionListeners()
ActionListener
組成的陣列。
ActionListener
,如果沒有添加偵聽器,則返回一個空陣列protected ChangeListener createChangeListener()
ChangeEvent
的子類別可以覆寫此方法,以返回另一個 ChangeListener
實作。
ChangeListener
protected void fireActionPerformed(ActionEvent event)
event
參數以延遲方式創建事件實例。
event
- ActionEvent
物件EventListenerList
protected void fireItemStateChanged(ItemEvent event)
event
參數以延遲方式創建事件實例。
event
- ItemEvent
物件EventListenerList
protected ActionListener createActionListener()
protected ItemListener createItemListener()
public void setEnabled(boolean b)
JComponent
中的 setEnabled
b
- true 表示啟用按鈕,否則為 falseComponent.isEnabled()
,
Component.isLightweight()
@Deprecated public String getLabel()
getText
取代
String
@Deprecated public void setLabel(String label)
setText(text)
取代
label
- 套件含文本的 String
public void addItemListener(ItemListener l)
ItemListener
添加到 checkbox
中。
ItemSelectable
中的 addItemListener
l
- 要添加的 ItemListener
ItemEvent
public void removeItemListener(ItemListener l)
ItemListener
。
ItemSelectable
中的 removeItemListener
l
- 要移除的 ItemListener
ItemEvent
public ItemListener[] getItemListeners()
ItemListener
組成的陣列。
ItemListener
,如果沒有添加偵聽器,則返回一個空陣列public Object[] getSelectedObjects()
null
。
ItemSelectable
中的 getSelectedObjects
null
protected void init(String text, Icon icon)
public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Icon
的 Image
不等於傳入的 Image
img
時返回 false。
ImageObserver
中的 imageUpdate
Component
中的 imageUpdate
img
- 要比較的 Image
infoflags
- 更新圖像時用於重繪按鈕的標誌,它確定將繪製多大的區域x
- x 坐標y
- y 坐標w
- 寬度h
- 高度
false
;否則返回 true
。ImageObserver
,
Component.imageUpdate(java.awt.Image, int, int, int, int, int)
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。