| java.lang.Object
 java.awt.Component
java.awt.Button
| Button | | public class Button extends Component (Code) | | This class creates a labeled button. The application can cause
some action to happen when the button is pushed. This image
depicts three views of a "Quit" button as it appears
under the Solaris operating system:
The first view shows the button as it appears normally.
The second view shows the button
when it has input focus. Its outline is darkened to let the
user know that it is an active object. The third view shows the
button when the user clicks the mouse over the button, and thus
requests that an action be performed.
The gesture of clicking on a button with the mouse
is associated with one instance of ActionEvent,
which is sent out when the mouse is both pressed and released
over the button. If an application is interested in knowing
when the button has been pressed but not released, as a separate
gesture, it can specialize processMouseEvent,
or it can register itself as a listener for mouse events by
calling addMouseListener. Both of these methods are
defined by Component, the abstract superclass of
all components.
When a button is pressed and released, AWT sends an instance
of ActionEvent to the button, by calling
processEvent on the button. The button's
processEvent method receives all events
for the button; it passes an action event along by
calling its own processActionEvent method.
The latter method passes the action event on to any action
listeners that have registered an interest in action
events generated by this button.
If an application wants to perform some action based on
a button being pressed and released, it should implement
ActionListener and register the new listener
to receive events from this button, by calling the button's
addActionListener method. The application can
make use of the button's action command as a messaging protocol.
version:
1.39 06/12/97
author:
Sami Shaio
See Also: java.awt.event.ActionEvent
See Also: java.awt.event.ActionListener
See Also: java.awt.Component.processMouseEvent
See Also: java.awt.Component.addMouseListener
since:
JDK1.0 |
| Constructor Summary | |
| public | Button()
Constructs a Button with no label. | | public | Button(String label)
Constructs a Button with the specified label. |
| Button | | public Button()(Code) | | Constructs a Button with no label.
since:
JDK1.0 |
| Button | | public Button(String label)(Code) | | Constructs a Button with the specified label.
Parameters:
label - A string label for the button.
since:
JDK1.0 |
| constructComponentName | | String constructComponentName()(Code) | | Construct a name for this component. Called by getName() when the
name is null.
|
| getActionCommand | | public String getActionCommand()(Code) | | Returns the command name of the action event fired by this button.
|
| paramString | | protected String paramString()(Code) | | Returns the parameter string representing the state of this
button. This string is useful for debugging.
the parameter string of this button.
since:
JDK1.0 |
| processActionEvent | | protected void processActionEvent(ActionEvent e)(Code) | | Processes action events occurring on this button
by dispatching them to any registered
ActionListener objects.
This method is not called unless action events are
enabled for this button. Action events are enabled
when one of the following occurs:
- An
ActionListener object is registered
via addActionListener.
- Action events are enabled via
enableEvents.
Parameters:
e - the action event.
See Also: java.awt.event.ActionListener
See Also: java.awt.Button.addActionListener
See Also: java.awt.Component.enableEvents
since:
JDK1.1 |
| setActionCommand | | public void setActionCommand(String command)(Code) | | Sets the command name for the action event fired
by this button. By default this action command is
set to match the label of the button.
Parameters:
command - A string used to set the button'saction command.
See Also: java.awt.event.ActionEvent
since:
JDK1.1 |
| setLabel | | public synchronized void setLabel(String label)(Code) | | Sets the button's label to be the specified string.
Parameters:
label - the new label, or nullif the button has no label.
See Also: java.awt.Button.getLabel
since:
JDK1.0 |
| Methods inherited from java.awt.Component | public boolean action(Event evt, Object what)(Code)(Java Doc)
public synchronized void add(PopupMenu popup)(Code)(Java Doc)
public synchronized void addComponentListener(ComponentListener l)(Code)(Java Doc)
public synchronized void addFocusListener(FocusListener l)(Code)(Java Doc)
public synchronized void addKeyListener(KeyListener l)(Code)(Java Doc)
public synchronized void addMouseListener(MouseListener l)(Code)(Java Doc)
public synchronized void addMouseMotionListener(MouseMotionListener l)(Code)(Java Doc)
public void addNotify()(Code)(Java Doc)
boolean areInputMethodsEnabled()(Code)(Java Doc)
public Rectangle bounds()(Code)(Java Doc)
final void checkEnableNewEventsOnly(Object listener)(Code)(Java Doc)
public int checkImage(Image image, ImageObserver observer)(Code)(Java Doc)
public int checkImage(Image image, int width, int height, ImageObserver observer)(Code)(Java Doc)
protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)(Code)(Java Doc)
String constructComponentName()(Code)(Java Doc)
public boolean contains(int x, int y)(Code)(Java Doc)
public boolean contains(Point p)(Code)(Java Doc)
public Image createImage(ImageProducer producer)(Code)(Java Doc)
public Image createImage(int width, int height)(Code)(Java Doc)
ComponentXWindow createXWindow()(Code)(Java Doc)
public void deliverEvent(Event e)(Code)(Java Doc)
public void disable()(Code)(Java Doc)
final protected void disableEvents(long eventsToDisable)(Code)(Java Doc)
final public void dispatchEvent(AWTEvent e)(Code)(Java Doc)
void dispatchEventImpl(AWTEvent e)(Code)(Java Doc)
public void doLayout()(Code)(Java Doc)
public void enable()(Code)(Java Doc)
public void enable(boolean b)(Code)(Java Doc)
final protected synchronized void enableEvents(long eventsToEnable)(Code)(Java Doc)
boolean eventEnabled(AWTEvent e)(Code)(Java Doc)
Component findFocusDelegate(Container container)(Code)(Java Doc)
public float getAlignmentX()(Code)(Java Doc)
public float getAlignmentY()(Code)(Java Doc)
public Color getBackground()(Code)(Java Doc)
public Rectangle getBounds()(Code)(Java Doc)
public ColorModel getColorModel()(Code)(Java Doc)
public Component getComponentAt(int x, int y)(Code)(Java Doc)
public Component getComponentAt(Point p)(Code)(Java Doc)
public Cursor getCursor()(Code)(Java Doc)
Component getFocusDelegate()(Code)(Java Doc)
public Font getFont()(Code)(Java Doc)
Component getFontAndColorDelegate()(Code)(Java Doc)
public FontMetrics getFontMetrics(Font font)(Code)(Java Doc)
public Color getForeground()(Code)(Java Doc)
public Graphics getGraphics()(Code)(Java Doc)
InputContext getInputContext()(Code)(Java Doc)
public Locale getLocale()(Code)(Java Doc)
public Point getLocation()(Code)(Java Doc)
public Point getLocationOnScreen()(Code)(Java Doc)
public Dimension getMaximumSize()(Code)(Java Doc)
public Dimension getMinimumSize()(Code)(Java Doc)
public String getName()(Code)(Java Doc)
Container getNativeContainer()(Code)(Java Doc)
public Container getParent()(Code)(Java Doc)
public Dimension getPreferredSize()(Code)(Java Doc)
public Dimension getSize()(Code)(Java Doc)
public Toolkit getToolkit()(Code)(Java Doc)
final public Object getTreeLock()(Code)(Java Doc)
public boolean gotFocus(Event evt, Object what)(Code)(Java Doc)
public boolean handleEvent(Event evt)(Code)(Java Doc)
public void hide()(Code)(Java Doc)
public boolean imageUpdate(Image img, int flags, int x, int y, int w, int h)(Code)(Java Doc)
public boolean inside(int x, int y)(Code)(Java Doc)
public void invalidate()(Code)(Java Doc)
static void invokeAndWait(Runnable runnable)(Code)(Java Doc)
public boolean isDisplayable()(Code)(Java Doc)
public boolean isEnabled()(Code)(Java Doc)
public boolean isFocusTraversable()(Code)(Java Doc)
public boolean isLightweight()(Code)(Java Doc)
boolean isLightweightWhenDisplayable()(Code)(Java Doc)
public boolean isOpaque()(Code)(Java Doc)
public boolean isShowing()(Code)(Java Doc)
public boolean isValid()(Code)(Java Doc)
public boolean isVisible()(Code)(Java Doc)
public boolean keyDown(Event evt, int key)(Code)(Java Doc)
public boolean keyUp(Event evt, int key)(Code)(Java Doc)
public void layout()(Code)(Java Doc)
void lightweightPrint(Graphics g)(Code)(Java Doc)
public void list()(Code)(Java Doc)
public void list(PrintStream out)(Code)(Java Doc)
public void list(PrintStream out, int indent)(Code)(Java Doc)
public void list(PrintWriter out)(Code)(Java Doc)
public void list(PrintWriter out, int indent)(Code)(Java Doc)
public Component locate(int x, int y)(Code)(Java Doc)
public Point location()(Code)(Java Doc)
public boolean lostFocus(Event evt, Object what)(Code)(Java Doc)
public Dimension minimumSize()(Code)(Java Doc)
public boolean mouseDown(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseDrag(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseEnter(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseExit(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseMove(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseUp(Event evt, int x, int y)(Code)(Java Doc)
public void move(int x, int y)(Code)(Java Doc)
public void nextFocus()(Code)(Java Doc)
public void paint(Graphics g)(Code)(Java Doc)
public void paintAll(Graphics g)(Code)(Java Doc)
protected String paramString()(Code)(Java Doc)
public boolean postEvent(Event e)(Code)(Java Doc)
public Dimension preferredSize()(Code)(Java Doc)
public boolean prepareImage(Image image, ImageObserver observer)(Code)(Java Doc)
public boolean prepareImage(Image image, int width, int height, ImageObserver observer)(Code)(Java Doc)
public void print(Graphics g)(Code)(Java Doc)
public void printAll(Graphics g)(Code)(Java Doc)
protected void processComponentEvent(ComponentEvent e)(Code)(Java Doc)
protected void processEvent(AWTEvent e)(Code)(Java Doc)
protected void processFocusEvent(FocusEvent e)(Code)(Java Doc)
protected void processKeyEvent(KeyEvent e)(Code)(Java Doc)
protected void processMouseEvent(MouseEvent e)(Code)(Java Doc)
protected void processMouseMotionEvent(MouseEvent e)(Code)(Java Doc)
public synchronized void remove(MenuComponent popup)(Code)(Java Doc)
public synchronized void removeComponentListener(ComponentListener l)(Code)(Java Doc)
public synchronized void removeFocusListener(FocusListener l)(Code)(Java Doc)
public synchronized void removeKeyListener(KeyListener l)(Code)(Java Doc)
public synchronized void removeMouseListener(MouseListener l)(Code)(Java Doc)
public synchronized void removeMouseMotionListener(MouseMotionListener l)(Code)(Java Doc)
public void removeNotify()(Code)(Java Doc)
public void repaint()(Code)(Java Doc)
public void repaint(long tm)(Code)(Java Doc)
public void repaint(int x, int y, int width, int height)(Code)(Java Doc)
public void repaint(long tm, int x, int y, int width, int height)(Code)(Java Doc)
public void requestFocus()(Code)(Java Doc)
public void reshape(int x, int y, int width, int height)(Code)(Java Doc)
public void resize(int width, int height)(Code)(Java Doc)
public void resize(Dimension d)(Code)(Java Doc)
public void setBackground(Color c)(Code)(Java Doc)
public void setBounds(int x, int y, int width, int height)(Code)(Java Doc)
public void setBounds(Rectangle r)(Code)(Java Doc)
public synchronized void setCursor(Cursor cursor)(Code)(Java Doc)
public void setEnabled(boolean b)(Code)(Java Doc)
public void setFont(Font f)(Code)(Java Doc)
public void setForeground(Color c)(Code)(Java Doc)
public void setLocale(Locale l)(Code)(Java Doc)
public void setLocation(int x, int y)(Code)(Java Doc)
public void setLocation(Point p)(Code)(Java Doc)
public void setName(String name)(Code)(Java Doc)
public void setSize(int width, int height)(Code)(Java Doc)
public void setSize(Dimension d)(Code)(Java Doc)
public void setVisible(boolean b)(Code)(Java Doc)
public void show()(Code)(Java Doc)
public void show(boolean b)(Code)(Java Doc)
public Dimension size()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
public void transferFocus()(Code)(Java Doc)
public void update(Graphics g)(Code)(Java Doc)
public void validate()(Code)(Java Doc)
|
|
|