java.awt
クラス Button

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Button

すべての実装インタフェース:

Accessible, ImageObserver, MenuContainer, Serializable

public class Button

extends Component

implements Accessible

このクラスはラベル付きボタンを作成します。アプリケーションは、ボタンが押されたときにアクションが実行されるようにすることができます。このイメージは、Solaris オペレーティングシステムで表示される "Quit" ボタンの 3 つのビューを表します。

1 番目のビューは通常の状態のボタンを示します。2 番目のビューは入力フォーカスがあるときのボタンを示します。ボタンの輪郭は暗くなり、アクティブなオブジェクトであることをユーザに示します。3 番目のビューは、ユーザがボタンの上でマウスをクリックし、アクションの実行を要求したときのボタンを示します。

マウスを使ってボタンをクリックするジェスチャーは、マウスがボタン上で押されて離されたときに送信される ActionEvent のインスタンスに関連しています。いつボタンが押されたかの通知は必要であるが、いつ離されたかの通知は必要でない場合、アプリケーションは、独立したジェスチャーとして processMouseEvent を特殊化することも、addMouseListener を呼び出すことによりマウスイベントのリスナーとして自身を登録することもできます。これらのメソッドは両方とも、すべてのコンポーネントの抽象スーパークラスである Component によって定義されます。

ボタンが押されて離されると、AWT はボタンの processEvent を呼び出すことにより、ボタンに ActionEvent のインスタンスを送ります。ボタンの processEvent メソッドはそのボタンのすべてのイベントを受け取ります。ボタンは自身の processActionEvent メソッドを呼び出すことによってアクションイベントを渡します。後者のメソッドはこのボタンによって生成されるアクションイベントの通知を対象として登録されているアクションリスナーにアクションイベントを渡します。

押されて離されるボタンに基づいてアクションを実行する場合、アプリケーションは、ActionListener を実装し、ボタンの addActionListener メソッドを呼び出すことにより、このボタンからイベントを受け取るように新しいリスナーを登録する必要があります。アプリケーションはボタンのアクションコマンドをメッセージプロトコルとして使用します。

導入されたバージョン:

JDK1.0

関連項目:

ActionEvent, ActionListener, Component.processMouseEvent(java.awt.event.MouseEvent), Component.addMouseListener(java.awt.event.MouseListener), 直列化された形式

内部クラスの概要

protected class

Button.AccessibleAWTButton このクラスは Button クラス用のユーザ補助機能のサポートを実装しています。

クラス java.awt.Component から継承した内部クラス

Component.AccessibleAWTComponent

クラス java.awt.Component から継承したフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェース java.awt.image.ImageObserver から継承したフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

コンストラクタの概要

Button()
ラベルなしのボタンを構築します。

Button(String label)
指定されたラベルが付いたボタンを構築します。

メソッドの概要

void	addActionListener(ActionListener l) このボタンからアクションイベントを受け取るために、指定されたアクションリスナーを追加します。
void	addNotify() ボタンのピアを構築します。
AccessibleContext	getAccessibleContext() このボタンに関連した AccessibleContext を返します。
String	getActionCommand() このボタンで発生するアクションイベントのコマンド名を返します。
String	getLabel() ボタンのラベルを返します。
EventListener[]	getListeners(Class listenerType) addXXXListener() を持つ Button に追加された全リスナーの配列を返します。
protected String	paramString() このボタンの状態を表すパラメータ文字列を返します。
protected void	processActionEvent(ActionEvent e) このボタンで発生するアクションイベントを、登録されている ActionListener オブジェクトにディスパッチすることにより、アクションイベントを処理します。
protected void	processEvent(AWTEvent e) このボタンに関するイベントを処理します。
void	removeActionListener(ActionListener l) このボタンからアクションイベントを受け取らないように、指定されたアクションリスナーを削除します。
void	setActionCommand(String command) このボタンによってトリガーされるアクションイベントのコマンド名を設定します。
void	setLabel(String label) ボタンのラベルを、指定された文字列に設定します。

クラス java.awt.Component から継承したメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getName, getParent, getPeer, getPreferredSize, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, 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, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFont, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, update, validate

クラス java.lang.Object から継承したメソッド

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

コンストラクタの詳細

Button

public Button()

ラベルなしのボタンを構築します。

Button

public Button(String label)

指定されたラベルが付いたボタンを構築します。

パラメータ:

label - ボタンの文字列ラベル

メソッドの詳細

addNotify

public void addNotify()

ボタンのピアを構築します。ボタンのピアは、アプリケーションが機能を変更せずにボタンの外観を変更できるようにします。

オーバーライド:

クラス Component 内の addNotify

関連項目:

Toolkit.createButton(java.awt.Button), 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 の場合、アクションコマンドはボタンのラベルと一致するように設定される

導入されたバージョン:

JDK1.1

関連項目:

ActionEvent

getActionCommand

public String getActionCommand()

このボタンで発生するアクションイベントのコマンド名を返します。コマンド名が null (デフォルト) の場合、このメソッドはボタンのラベルを返します。

addActionListener

public void addActionListener(ActionListener l)

このボタンからアクションイベントを受け取るために、指定されたアクションリスナーを追加します。アクションイベントは、ユーザがこのボタンの上でマウスボタンを押したり、離したりしたときに発生します。l が null の場合、例外はスローされず、アクションは実行されません。

パラメータ:

l - アクションリスナー

導入されたバージョン:

JDK1.1

関連項目:

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

removeActionListener

public void removeActionListener(ActionListener l)

このボタンからアクションイベントを受け取らないように、指定されたアクションリスナーを削除します。アクションイベントは、ユーザがこのボタンの上でマウスボタンを押したり、離したりしたときに発生します。l が null の場合、例外はスローされず、アクションは実行されません。

パラメータ:

l - アクションリスナー

導入されたバージョン:

JDK1.1

関連項目:

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

getListeners

public EventListener[] getListeners(Class listenerType)

addXXXListener() を持つ Button に追加された全リスナーの配列を返します。XXX は listenerType の引数の名前です。たとえば、指定された Button b の ActionListener(s) をすべて取得するには、次のように記述します。

 ActionListener[] als = (ActionListener[])(b.getListeners(ActionListener.class))

該当するリスナーリストが存在しない場合は、空の配列が返されます。

オーバーライド:

クラス Component 内の getListeners

パラメータ:

listenerType - 要求されたリスナーのタイプ

戻り値:

このボタンによってサポートされる、指定されたタイプのすべてのリスナー

導入されたバージョン:

1.3

processEvent

protected void processEvent(AWTEvent e)

このボタンに関するイベントを処理します。イベントが ActionEvent のインスタンスである場合、このメソッドは processActionEvent メソッドを呼び出します。そうでない場合は、スーパークラスの processEvent を呼び出します。

オーバーライド:

クラス Component 内の processEvent

パラメータ:

e - イベント

導入されたバージョン:

JDK1.1

関連項目:

ActionEvent, processActionEvent(java.awt.event.ActionEvent)

processActionEvent

protected void processActionEvent(ActionEvent e)

このボタンで発生するアクションイベントを、登録されている ActionListener オブジェクトにディスパッチすることにより、アクションイベントを処理します。

このボタンに対してアクションイベントが使用可能でない場合、このメソッドは呼び出されません。アクションイベントは、次のどれかの場合に使用可能になります。

• ActionListener オブジェクトが addActionListener によって登録されている
• enableEvents によってアクションイベントが使用可能になっている

パラメータ:

e - アクションイベント

導入されたバージョン:

JDK1.1

関連項目:

ActionListener, addActionListener(java.awt.event.ActionListener), Component.enableEvents(long)

paramString

protected String paramString()

このボタンの状態を表すパラメータ文字列を返します。この文字列はデバッグの際に便利です。

オーバーライド:

クラス Component 内の paramString

戻り値:

このボタンのパラメータ文字列

getAccessibleContext

public AccessibleContext getAccessibleContext()

このボタンに関連した AccessibleContext を返します。ボタンの場合、AccessibleContext は AccessibleAWTButton の形式を取ります。必要に応じて新規の AccessibleAWTButton インスタンスが作成されます。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Component 内の getAccessibleContext

戻り値:

このボタンの AccessibleContext として機能する AccessibleAWTButton