- すべての実装されたインタフェース:
ImageObserver
,MenuContainer
,Serializable
,Accessible
Quit
ボタンの3つのビューを表します。
1番目のビューは通常の状態のボタンを示します。 2番目のビューは入力フォーカスがあるときのボタンを示します。 ボタンの輪郭は暗くなり、アクティブなオブジェクトであることをユーザーに示します。 3番目のビューは、ユーザーがボタンの上でマウスをクリックし、アクションの実行を要求したときのボタンを示します。
マウスを使ってボタンをクリックするジェスチャは、マウスがボタン上で押されて離されたときに送信されるActionEvent
のインスタンスに関連付けられています。 いつボタンが押されたかを通知される必要はあっても、いつ離されたかを通知される必要がないアプリケーションの場合は、それらを独立したジェスチャとしてprocessMouseEvent
を特殊化したり、addMouseListener
を呼び出すことによりマウス・イベントのリスナーとして自身を登録したりできます。 これらのメソッドは両方とも、すべてのコンポーネントの抽象スーパー・クラスであるComponent
によって定義されています。
ボタンが押されて離されると、AWTはボタンのprocessEvent
を呼び出すことにより、ボタンにActionEvent
のインスタンスを送ります。 ボタンのprocessEvent
メソッドはそのボタンのすべてのイベントを受け取ります。ボタンは自身のprocessActionEvent
メソッドを呼び出すことによってアクション・イベントを渡します。 後者のメソッドはこのボタンによって生成されるアクション・イベントの通知を対象として登録されているアクション・リスナーにアクション・イベントを渡します。
ボタン押されて離されることに基づいてアクションを実行するアプリケーションの場合は、addActionListener
を実装し、ボタンのActionListener
メソッドを呼び出すことにより、このボタンからイベントを受け取るように新しいリスナーを登録する必要があります。 アプリケーションはボタンのアクション・コマンドをメッセージ・プロトコルとして使用します。
-
ネストされたクラスのサマリー
ネストされたクラスクラス java.awt.Componentで宣言されたネストされたクラス/インタフェース
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
フィールドのサマリー
クラス java.awt.Componentで宣言されたフィールド
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
インタフェース java.awt.image.ImageObserverで宣言されたフィールド
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明void
このボタンからアクション・イベントを受け取るために、指定されたアクション・リスナーを追加します。void
ボタンのピアを構築します。このButton
に関連付けられているAccessibleContext
を取得します。このボタンでトリガーされるアクション・イベントのコマンド名を返します。このボタンに登録されたすべてのアクション・リスナーの配列を返します。getLabel()
ボタンのラベルを取得します。<T extends EventListener>
T[]getListeners(Class<T> listenerType)
このButton
にFooListener
として現在登録されているすべてのオブジェクトの配列を返します。protected String
このButton
の状態を表す文字列を返します。protected void
このボタンで発生するアクション・イベントを、登録されているActionListener
オブジェクトにディスパッチすることによって処理します。protected void
processEvent(AWTEvent e)
このボタンのイベントを処理します。void
以降このボタンからアクション・イベントを受け取らないように、指定されたアクション・リスナーを削除します。void
setActionCommand(String command)
このボタンによってトリガーされるアクション・イベントのコマンド名を設定します。void
ボタンのラベルを、指定された文字列に設定します。クラス java.awt.Componentで宣言されたメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate
-
コンストラクタの詳細
-
ボタン
public Button() throws HeadlessExceptionそのラベルの空の文字列を持つボタンを構築します。- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 関連項目:
GraphicsEnvironment.isHeadless()
-
ボタン
public Button(String label) throws HeadlessException指定されたラベルを持つボタンを構築します。- パラメータ:
label
- ボタンの文字列ラベル。ラベルがない場合はnull
- 例外:
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合- 関連項目:
GraphicsEnvironment.isHeadless()
-
-
メソッドの詳細
-
addNotify
public void addNotify()ボタンのピアを構築します。 ボタンのピアは、アプリケーションが機能を変更せずにボタンの外観を変更できるようにします。- オーバーライド:
addNotify
、クラス:Component
- 関連項目:
Component.getToolkit()
-
getLabel
public String getLabel()ボタンのラベルを取得します。- 戻り値:
- ボタンのラベル。ボタンにラベルがない場合は
null
- 関連項目:
setLabel(java.lang.String)
-
setLabel
public void setLabel(String label)ボタンのラベルを、指定された文字列に設定します。- パラメータ:
label
- 新しいラベル。ボタンにラベルがない場合はnull
- 関連項目:
getLabel()
-
setActionCommand
public void setActionCommand(String command)このボタンによってトリガーされるアクション・イベントのコマンド名を設定します。 デフォルトでは、このアクション・コマンドはボタンのラベルと一致するように設定されます。- パラメータ:
command
- ボタンのアクション・コマンドを設定するために使用する文字列。 文字列がnull
の場合、アクション・コマンドはボタンのラベルと一致するように設定される- 導入されたバージョン:
- 1.1
- 関連項目:
ActionEvent
-
getActionCommand
public String getActionCommand()このボタンでトリガーされるアクション・イベントのコマンド名を返します。 コマンド名がnull
(デフォルト)の場合、このメソッドはボタンのラベルを返します。- 戻り値:
- このボタンのアクション・コマンド名(またはラベル)
-
addActionListener
public void addActionListener(ActionListener l)このボタンからアクション・イベントを受け取るために、指定されたアクション・リスナーを追加します。 アクション・イベントは、ユーザーがこのボタンの上でマウス・ボタンを押したり、離したりしたときに発生します。 lがnullの場合、例外はスローされず、処理も実行されません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- アクション・リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
removeActionListener(java.awt.event.ActionListener)
,getActionListeners()
,ActionListener
-
removeActionListener
public void removeActionListener(ActionListener l)以降このボタンからアクション・イベントを受け取らないように、指定されたアクション・リスナーを削除します。 アクション・イベントは、ユーザーがこのボタンの上でマウス・ボタンを押したり、離したりしたときに発生します。 lがnullの場合、例外はスローされず、処理も実行されません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- アクション・リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
addActionListener(java.awt.event.ActionListener)
,getActionListeners()
,ActionListener
-
getActionListeners
public ActionListener[] getActionListeners()このボタンに登録されたすべてのアクション・リスナーの配列を返します。- 戻り値:
- このボタンのすべての
ActionListener
。アクション・リスナーが現在登録されていない場合は空の配列 - 導入されたバージョン:
- 1.4
- 関連項目:
addActionListener(java.awt.event.ActionListener)
,removeActionListener(java.awt.event.ActionListener)
,ActionListener
-
getListeners
public <T extends EventListener> T[] getListeners(Class<T> listenerType)このButton
にFooListener
として現在登録されているすべてのオブジェクトの配列を返します。FooListener
は、addFooListener
メソッドを使用して登録されます。FooListener.class
などのクラス・リテラルを使用してlistenerType
引数を指定できます。 たとえば、次のコードを使用して、Button b
のアクション・リスナーを照会できます。ActionListener[] als = (ActionListener[])(b.getListeners(ActionListener.class));
このようなリスナーがない場合は空の配列を返します。- オーバーライド:
getListeners
、クラス:Component
- 型パラメータ:
T
- リスナーの型- パラメータ:
listenerType
- 要求されるリスナーの型。次の下位インタフェースを指定:java.util.EventListener
- 戻り値:
- このボタン上で
FooListener
として登録されたすべてのオブジェクトの配列、またはこのようなリスナーが追加されていない場合は空の配列 - 例外:
ClassCastException
-listenerType
で、java.util.EventListener
を実装するクラスまたはインタフェースが指定されなかった場合- 導入されたバージョン:
- 1.3
- 関連項目:
getActionListeners()
-
processEvent
protected void processEvent(AWTEvent e)このボタンのイベントを処理します。 イベントがActionEvent
のインスタンスである場合、このメソッドはprocessActionEvent
メソッドを呼び出します。 それ以外の場合は、スーパー・クラスのprocessEvent
を呼び出します。イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- オーバーライド:
processEvent
、クラス:Component
- パラメータ:
e
- イベント- 導入されたバージョン:
- 1.1
- 関連項目:
ActionEvent
,processActionEvent(java.awt.event.ActionEvent)
-
processActionEvent
protected void processActionEvent(ActionEvent e)このボタンで発生するアクション・イベントを、登録されているActionListener
オブジェクトにディスパッチすることによって処理します。このボタンに対してアクション・イベントが使用可能でない場合、このメソッドは呼び出されません。 アクション・イベントは、次のどちらかの場合に使用可能になります。
ActionListener
オブジェクトがaddActionListener
によって登録されている。enableEvents
によってアクション・イベントが使用可能になっている。
イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- アクション・イベント- 導入されたバージョン:
- 1.1
- 関連項目:
ActionListener
,addActionListener(java.awt.event.ActionListener)
,Component.enableEvents(long)
-
paramString
protected String paramString()このButton
の状態を表す文字列を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、null
にはできません。- オーバーライド:
paramString
、クラス:Component
- 戻り値:
- このボタンのパラメータ文字列
-
getAccessibleContext
@BeanProperty(expert=true, description="The AccessibleContext associated with this Button.") public AccessibleContext getAccessibleContext()このButton
に関連付けられているAccessibleContext
を取得します。 ボタンの場合、AccessibleContext
はAccessibleAWTButton
の形式を取ります。 必要に応じて、新しいAccessibleAWTButton
インスタンスが作成されます。- 定義:
getAccessibleContext
、インタフェース:Accessible
- オーバーライド:
getAccessibleContext
、クラス:Component
- 戻り値:
- この
Button
のAccessibleContext
として機能するAccessibleAWTButton
- 導入されたバージョン:
- 1.3
-