Packages  This Package  Prev  Next  Index  

public  class  java.awt.Button
    extends  java.awt.Component  (II-§1.10)
{
        // Constructors
    public Button();	§1.2.1
    public Button(String  label);	§1.2.2

        // Methods
    public void addNotify();	§1.2.3
    public String getLabel();	§1.2.4
    protected String paramString();	§1.2.5
    public void setLabel(String  label);	§1.2.6
}

This class creates a labeled button. The application can cause some action to happen when the button is pushed. Below are three views of a "Quit" button in Solaris:

The first shows the button normally. The second shows the button when it has the input focus: the darkening of the outline lets the user know that this is an active object. The third shows the button when the user clicks the mouse over the button, and thus requests that the mouse's action(s) be performed.

When a button is pushed and released¹, AWT sends an action event (II-§1.14.11) to the button. This event's target is the button, and its object is the string label of the button. An application should override the action method (II-§1.10.1) of the button or of one of its containing windows in order to cause some action to occur.

Creates a button with no label.

Creates a button with the indicated label.

Parameters:

label - a string label for the button

This method calls the createButton method (II-§1.41.3) of the button's toolkit (II-§1.10.20) in order to create a ButtonPeer (II-§3.1) for this button. This peer allows the application to change the look of a button without changing its functionality.

Most applications do not call this method directly.

Overrides:

addNotify in class Component (II-§1.10.2).

Returns:

the label of this button, or null if this button has no label.

See Also:

setLabel (II-§1.2.6).

Returns the parameter string representing the state of this button. This string is useful for debugging.

Returns:

the parameter string of this button.

Overrides:

paramString in class Component (II-§1.10.51).

Changes this button's label to be the String argument.

Parameters:

label - the new label, or null for no label

See Also:

getLabel (II-§1.2.4).

Packages  This Package  Prev  Next  Index