ucb.gui

Class Pad

java.lang.Object

ucb.gui.Widget

ucb.gui.Pad

public class Pad
extends Widget

A Pad is a blank slate that may be inserted into a TopLevel. It provides methods that set up responses to mouse events, and an overrideable paintComponent method that allows one to draw anything that may be rendered on a standard Java Graphics2D. Standard usage is to extend Pad.

Field Summary

Fields inherited from class ucb.gui.Widget

me

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Pad() A new, empty Pad.

Method Summary

Modifier and Type	Method and Description
int	getHeight() Return my current height in pixels.
int	getWidth() Return my current width in pixels.
protected void	paintComponent(Graphics2D g) Repaint myself on G.
void	repaint() Alert the system that I ought be asked to repaint myself.
void	repaint(int x, int y, int width, int height) Alert the system that I ought be asked to repaint the rectangular area whose top left corner is X, Y and has given WIDTH and HEIGHT.
void	repaint(long tm) Alert the system that I ought be asked to repaint myself within TM milliseconds.
void	repaint(long tm, int x, int y, int width, int height) Alert the system that I ought be asked to repaint the rectangular area whose top left corner is X, Y and has given WIDTH and HEIGHT within TM milliseconds.
void	setKeyHandler(String event, Object receiver, String funcName) Set the handler of key events indicated by EVENT to the method named FUNCNAME in RECEIVER.
void	setKeyHandler(String event, String funcName) Set the handler of key events indicated by EVENT to my method named FUNCNAME.
void	setMaximumSize(int width, int height) Set my maximum size to WIDTH x HEIGHT pixels.
void	setMinimumSize(int width, int height) Set my minimum size to WIDTH x HEIGHT pixels.
void	setMouseHandler(String event, Object receiver, String funcName) Handle the mouse event EVENT by calling the FUNCNAME method on RECEIVER with the MouseEvent that describes the event.
void	setMouseHandler(String event, String funcName) Set the handler of mouse events indicated by EVENT to my method named FUNCNAME.
void	setPreferredSize(int width, int height) Set my preferred size to WIDTH x HEIGHT pixels.
void	setSize(int width, int height) Set my current size to WIDTH x HEIGHT pixels.

Methods inherited from class ucb.gui.Widget

requestFocusInWindow

Methods inherited from class java.lang.Object

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

Constructor Detail

Pad

protected Pad()

A new, empty Pad.

Method Detail

setSize

public void setSize(int width,
                    int height)

Set my current size to WIDTH x HEIGHT pixels.

setPreferredSize

public void setPreferredSize(int width,
                             int height)

Set my preferred size to WIDTH x HEIGHT pixels.

setMinimumSize

public void setMinimumSize(int width,
                           int height)

Set my minimum size to WIDTH x HEIGHT pixels.

setMaximumSize

public void setMaximumSize(int width,
                           int height)

Set my maximum size to WIDTH x HEIGHT pixels.

getWidth

public int getWidth()

Return my current width in pixels.

getHeight

public int getHeight()

Return my current height in pixels.

repaint

public void repaint()

Alert the system that I ought be asked to repaint myself.

repaint

public void repaint(long tm)

Alert the system that I ought be asked to repaint myself within TM milliseconds.

repaint

public void repaint(int x,
                    int y,
                    int width,
                    int height)

Alert the system that I ought be asked to repaint the rectangular area whose top left corner is X, Y and has given WIDTH and HEIGHT.

repaint

public void repaint(long tm,
                    int x,
                    int y,
                    int width,
                    int height)

Alert the system that I ought be asked to repaint the rectangular area whose top left corner is X, Y and has given WIDTH and HEIGHT within TM milliseconds.

setMouseHandler

public void setMouseHandler(String event,
                            Object receiver,
                            String funcName)

Handle the mouse event EVENT by calling the FUNCNAME method on RECEIVER with the MouseEvent that describes the event. FUNCNAME must be a declared method of RECEIVER that takes a single MouseEvent argument. The default handling of any event is to ignore it. The possible values of EVENT are:

• "click": A mouse button is clicked (pressed and released).
• "press": A mouse button is pressed.
• "release": A mouse button is released.
• "enter": The mouse enters this Pad.
• "exit": The mouse exits this Pad.
• "drag": The mouse dragged (moved while a button is pressed).
• "move": The mouse moves.

Mouse clicks follow releases (both occur), unless the mouse has been dragged, in which case one sees a press, one or more drags, and a release with no click.

See Also:

MouseEvent

setMouseHandler

public void setMouseHandler(String event,
                            String funcName)

Set the handler of mouse events indicated by EVENT to my method named FUNCNAME.

setKeyHandler

public void setKeyHandler(String event,
                          Object receiver,
                          String funcName)

Set the handler of key events indicated by EVENT to the method named FUNCNAME in RECEIVER. The possible events are

• "keypress": A key is pressed.
• "keyrelease": A key is released.
• "keytype": A key is typed (denoting a valid Unicode character).

Keytype events occur between a press and subsequent release event (all three occur if the key represents a Unicode character). Keytype events do not occur for typing of keys such as Ctrl, Shift, Meta, Insert, or function keys (F1, etc.) which do not correspond to Unicode characters.

setKeyHandler

public void setKeyHandler(String event,
                          String funcName)

Set the handler of key events indicated by EVENT to my method named FUNCNAME.

paintComponent

protected void paintComponent(Graphics2D g)

Repaint myself on G. This default implementation does nothing.