public abstract class AbstractButton extends JComponent implements ItemSelectable, SwingConstants
ボタンは、Action
によって、構成とある程度の制御が可能です。ボタンでAction
を使用することは、ボタンを直接構成するのと比べて多くの利点があります。詳細は「Action
をサポートするSwingコンポーネント」を参照してください。さらに、Java チュートリアルのActionsの使用方法のセクションに詳細が説明されています。
詳細は、『The Java Tutorial』の「How to Use Buttons, Check Boxes, and Radio Buttons」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。1.4以降、すべてのJavaBeans(tm)用の長期間の格納サポートがjava.beans
パッケージに追加されています。XMLEncoder
を参照してください。
修飾子と型 | クラスと説明 |
---|---|
protected class |
AbstractButton.AccessibleAbstractButton
このクラスは
AbstractButton クラスのアクセシビリティ・サポートを実装しています。 |
protected class |
AbstractButton.ButtonChangeListener
ChangeListener を拡張して、直列化できるようにします。 |
JComponent.AccessibleJComponent
Container.AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
修飾子と型 | フィールドと説明 |
---|---|
protected ActionListener |
actionListener
ボタン・モデルの
ActionListener 。 |
static String |
BORDER_PAINTED_CHANGED_PROPERTY
ボーダーが描画されるかどうかの変更を識別します。
|
protected ChangeEvent |
changeEvent
ChangeEvent の唯一の状態はソース・プロパティなので、ボタンの各インスタンスに必要なこのイベントは1つだけです。 |
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
ボタンの垂直方向のテキスト位置の変更を識別します。
|
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
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)
checkbox にItemListener を追加します。 |
protected int |
checkHorizontalKey(int key, String exception)
horizontalAlignment プロパティとhorizontalTextPosition プロパティに対してkey 引数が正当な値であるかどうかを判定します。 |
protected int |
checkVerticalKey(int key, String exception)
key 引数が垂直方向のプロパティにとって正当な値であるかどうかを判定します。 |
protected void |
configurePropertiesFromAction(Action a)
指定された
Action のプロパティに一致するように、このボタンにプロパティを設定します。 |
protected ActionListener |
createActionListener() |
protected PropertyChangeListener |
createActionPropertyChangeListener(Action a)
指定された
Action からの変更を待機し、適切なプロパティを更新する役割を担うPropertyChangeListener を作成して、返します。 |
protected ChangeListener |
createChangeListener()
サブクラスが別の方法で
ChangeEvents を処理する場合は、このメソッドをオーバーライドして別の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()
Look & Feelがニーモニック文字を表すための修飾を提供する文字をインデックスとして返します。
|
boolean |
getHideActionText()
ボタンが
Action からテキストを表示するかどうかを決定する、hideActionText プロパティの値を返します。 |
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)
ニーモニックを表すためにテキストのどの文字を装飾するかについてのヒントを、Look & Feelに提供します。
|
void |
setEnabled(boolean b)
ボタンを有効(または無効)にします。
|
void |
setFocusPainted(boolean b)
paintFocus プロパティを設定します。フォーカス状態をペイントするためには、このプロパティがtrue である必要があります。 |
void |
setHideActionText(boolean hideActionText)
ボタンが
Action からテキストを表示するかどうかを決定する、hideActionText プロパティを設定します。 |
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()
現在のLook & Feelからの値にUIプロパティをリセットします。
|
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, 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, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, 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
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, transferFocusDownCycle, validate, validateTree
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, getAccessibleContext, 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, 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, transferFocusBackward, transferFocusUpCycle
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
の唯一の状態はソース・プロパティなので、ボタンの各インスタンスに必要なこのイベントは1つだけです。生成されるイベントのソースは、常にthisです。public void setHideActionText(boolean hideActionText)
Action
からテキストを表示するかどうかを決定する、hideActionText
プロパティを設定します。これは、ボタンにAction
がインストールされている場合にのみ使用できます。hideActionText
- ボタンのtext
プロパティがAction
のプロパティを反映しない場合はtrue
。デフォルトはfalse
Action
をサポートするSwingコンポーネントpublic boolean getHideActionText()
Action
からテキストを表示するかどうかを決定する、hideActionText
プロパティの値を返します。これは、ボタンに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()
Look & Feelによっては無効な状態のアイコンがレンダリングされないことがあり、その場合、無効な状態のアイコンは無視されます。
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()
が呼び出されます。
Look & Feelによっては、無効で、かつ選択されている状態のアイコンがレンダリングされないことがあり、その場合、これは無視されます。
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)
horizontalAlignment
プロパティとhorizontalTextPosition
プロパティに対してkey
引数が正当な値であるかどうかを判定します。有効な値は次のとおりです。
SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING
key
- チェックするプロパティ値exception
- 値が無効である場合にスローされるIllegalArgumentException
で使用されるメッセージkey
引数IllegalArgumentException
- キーが前述の正当な値のリストにない場合setHorizontalTextPosition(int)
, setHorizontalAlignment(int)
protected int checkVerticalKey(int key, String exception)
key
引数が垂直方向のプロパティにとって正当な値であるかどうかを判定します。有効な値は次のとおりです。
SwingConstants.CENTER
SwingConstants.TOP
SwingConstants.BOTTOM
key
- チェックするプロパティ値exception
- 値が無効である場合にスローされるIllegalArgumentException
で使用されるメッセージkey
引数IllegalArgumentException
- キーが前述の正当な値のリストにない場合public void removeNotify()
KeyboardAction
が削除されます。このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。removeNotify
、クラス: JComponent
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
と置き換わりますが、ActionListeners
で独立して追加されたaddActionListener
には影響しません。Action
がボタンにすでに登録されているActionListener
である場合、再登録されません。
Action
を設定すると、「Action
をサポートするSwingコンポーネント」で説明されているすべてのプロパティがすぐに変更されます。続いて、Action
のプロパティの変更に合わせて、ボタンのプロパティが自動的に更新されます。
このメソッドは、Action
のプロパティ値を設定し、追跡するために、ほかの3つのメソッドを使用します。このメソッドは、ボタンのプロパティをただちに変更するために、configurePropertiesFromAction
メソッドを使用します。Action
のプロパティ値の変更を追跡するために、このメソッドはcreateActionPropertyChangeListener
から返されるPropertyChangeListener
を登録します。デフォルトのPropertyChangeListener
は、Action
のプロパティに変更があると、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)
Action
からの変更を待機し、適切なプロパティを更新する役割を担うPropertyChangeListener
を作成して、返します。
警告: これをサブクラス化する場合、匿名の内部クラスは作成しないでください。作成すると、ボタンの寿命がAction
の寿命に拘束されます。
a
- ボタンのアクションAction
, setAction(javax.swing.Action)
public boolean isBorderPainted()
borderPainted
プロパティを取得します。borderPainted
プロパティの値setBorderPainted(boolean)
public void setBorderPainted(boolean b)
borderPainted
プロパティを設定します。true
でボタンがボーダーを持つ場合は、ボーダーがペイントされます。borderPainted
プロパティのデフォルト値はtrue
です。
Look & FeelによってはborderPainted
プロパティがサポートされない場合があり、その場合、これは無視されます。
b
- trueであり、ボーダーのプロパティがnull
でない場合、ボーダーをペイントするisBorderPainted()
protected void paintBorder(Graphics g)
BorderPainted
プロパティがtrueであり、ボタンがボーダーを持つ場合、ボタンのボーダーをペイントします。paintBorder
、クラス: JComponent
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
です。一部のLook & Feelはフォーカス状態をペイントしないことがあります。それらはこのプロパティを無視します。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
です。一部のLook & Feelはロールオーバー効果を実装しないことがあります。それらはこのプロパティを無視します。b
- true
の場合、反転の効果をペイントするisRolloverEnabled()
public int getMnemonic()
public void setMnemonic(int mnemonic)
ニーモニックはキーボード上の1つのキーに対応している必要があり、java.awt.event.KeyEvent
で定義されるVK_XXX
キー・コードのどれかを使用して指定します。これらのコード、およびインターナショナル・キーボード用のより広いコードの配列をjava.awt.event.KeyEvent.getExtendedKeyCodeForChar
によって取得できます。大文字、小文字は区別されないため、対応するキー・コードのキー・イベントは、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
この値は、ニーモニックの変更(ニーモニック自身またはテキストの変更など)に関連するプロパティとして更新されます。デフォルトの文字を下線付きでないようにする場合、これだけを呼び出す必要があります。たとえば、ニーモニック「a」を持つテキスト「Save As」について、「Save As」のようにAを修飾する場合は、setMnemonic(KeyEvent.VK_A)
を呼び出してからsetDisplayedMnemonicIndex(5)
を呼び出します。
index
- 下線を付けるStringに対するインデックスIllegalArgumentException
- index
がテキストの長さ以上、または -1より小さい場合にスローされるgetDisplayedMnemonicIndex()
public int getDisplayedMnemonicIndex()
setDisplayedMnemonicIndex(int)
public void setMultiClickThreshhold(long threshhold)
threshhold
- マウスのボタンを押すイベントが対応するアクション・イベントを生成するまでの所要時間IllegalArgumentException
- しきい値が0より小さい場合getMultiClickThreshhold()
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));
protected void addImpl(Component comp, Object constraints, int index)
Container.addImpl(Component, Object, int)
を参照してください。addImpl
、クラス: Container
comp
- 追加されるコンポーネントconstraints
- このコンポーネントのレイアウト制約を表現するオブジェクトindex
- コンポーネントを挿入するコンテナのリスト内での位置。-1
は最後に挿入することを意味するIllegalArgumentException
- index
が無効である場合IllegalArgumentException
- コンテナの親をそのコンテナ自体に追加しようとしている場合IllegalArgumentException
- ウィンドウをコンテナに追加しようとしている場合Container.add(Component)
, Container.add(Component, int)
, Container.add(Component, java.lang.Object)
, Container.invalidate()
, LayoutManager
, LayoutManager2
public void setLayout(LayoutManager mgr)
Container.setLayout(LayoutManager)
を参照してください。setLayout
、クラス: Container
mgr
- 指定されたレイアウト・マネージャContainer.doLayout()
, Container.getLayout()
, Container.invalidate()
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()
ChangeEvents
を処理する場合は、このメソッドをオーバーライドして別の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)
setEnabled
、クラス: JComponent
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)
checkbox
にItemListener
を追加します。addItemListener
、インタフェース: ItemSelectable
l
- 追加されるItemListener
ItemEvent
public void removeItemListener(ItemListener l)
ItemListener
を削除します。removeItemListener
、インタフェース: ItemSelectable
l
- 削除するItemListener
ItemEvent
public ItemListener[] getItemListeners()
ItemListener
の配列を返します。ItemListener
。リスナーが追加されていない場合は空の配列public Object[] getSelectedObjects()
null
を返します。getSelectedObjects
、インタフェース: ItemSelectable
null
public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Icon
のImage
が、渡されたImage
img
と異なる場合は、オーバーライドされてfalseを返します。imageUpdate
、インタフェース: ImageObserver
imageUpdate
、クラス: Component
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
にはなりません。
JFCコンポーネントの特定の新しい側面についての情報を提供するには、paramString
をオーバーライドします。
paramString
、クラス: JComponent
AbstractButton
の文字列表現 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.