|
Préférences
Moteurs de recherche
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
java.awt.event
|
Field Summary | |
---|---|
static int |
BUTTON1
Indicates mouse button #1; used by getButton() . |
static int |
BUTTON2
Indicates mouse button #2; used by getButton() . |
static int |
BUTTON3
Indicates mouse button #3; used by getButton() . |
static int |
MOUSE_CLICKED
The "mouse clicked" event. |
static int |
MOUSE_DRAGGED
The "mouse dragged" event. |
static int |
MOUSE_ENTERED
The "mouse entered" event. |
static int |
MOUSE_EXITED
The "mouse exited" event. |
static int |
MOUSE_FIRST
The first number in the range of ids used for mouse events. |
static int |
MOUSE_LAST
The last number in the range of ids used for mouse events. |
static int |
MOUSE_MOVED
The "mouse moved" event. |
static int |
MOUSE_PRESSED
The "mouse pressed" event. |
static int |
MOUSE_RELEASED
The "mouse released" event. |
static int |
MOUSE_WHEEL
The "mouse wheel" event. |
static int |
NOBUTTON
Indicates no mouse buttons; used by getButton() . |
Fields inherited from class java.awt.event.InputEvent |
---|
ALT_DOWN_MASK, ALT_GRAPH_DOWN_MASK, ALT_GRAPH_MASK, ALT_MASK, BUTTON1_DOWN_MASK, BUTTON1_MASK, BUTTON2_DOWN_MASK, BUTTON2_MASK, BUTTON3_DOWN_MASK, BUTTON3_MASK, CTRL_DOWN_MASK, CTRL_MASK, META_DOWN_MASK, META_MASK, SHIFT_DOWN_MASK, SHIFT_MASK |
Fields inherited from class java.awt.event.ComponentEvent |
---|
COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN |
Fields inherited from class java.util.EventObject |
---|
source |
Constructor Summary | |
---|---|
MouseEvent(Component source,
int id,
long when,
int modifiers,
int x,
int y,
int clickCount,
boolean popupTrigger)
Constructs a MouseEvent object with the
specified source component,
type, modifiers, coordinates, and click count. |
|
MouseEvent(Component source,
int id,
long when,
int modifiers,
int x,
int y,
int clickCount,
boolean popupTrigger,
int button)
Constructs a MouseEvent object with the
specified source component,
type, modifiers, coordinates, and click count. |
|
MouseEvent(Component source,
int id,
long when,
int modifiers,
int x,
int y,
int xAbs,
int yAbs,
int clickCount,
boolean popupTrigger,
int button)
Constructs a MouseEvent object with the
specified source component,
type, modifiers, coordinates, absolute coordinates, and click count. |
Method Summary | |
---|---|
int |
getButton()
Returns which, if any, of the mouse buttons has changed state. |
int |
getClickCount()
Returns the number of mouse clicks associated with this event. |
Point |
getLocationOnScreen()
Returns the absolute x, y position of the event. |
static String |
getMouseModifiersText(int modifiers)
Returns a String describing the modifier keys and
mouse buttons that were down during the event, such as "Shift",
or "Ctrl+Shift". |
Point |
getPoint()
Returns the x,y position of the event relative to the source component. |
int |
getX()
Returns the horizontal x position of the event relative to the source component. |
int |
getXOnScreen()
Returns the absolute horizontal x position of the event. |
int |
getY()
Returns the vertical y position of the event relative to the source component. |
int |
getYOnScreen()
Returns the absolute vertical y position of the event. |
boolean |
isPopupTrigger()
Returns whether or not this mouse event is the popup menu trigger event for the platform. |
String |
paramString()
Returns a parameter string identifying this event. |
void |
translatePoint(int x,
int y)
Translates the event's coordinates to a new position by adding specified x (horizontal) and y
(vertical) offsets. |
Methods inherited from class java.awt.event.InputEvent |
---|
consume, getModifiers, getModifiersEx, getModifiersExText, getWhen, isAltDown, isAltGraphDown, isConsumed, isControlDown, isMetaDown, isShiftDown |
Methods inherited from class java.awt.event.ComponentEvent |
---|
getComponent |
Methods inherited from class java.awt.AWTEvent |
---|
getID, setSource, toString |
Methods inherited from class java.util.EventObject |
---|
getSource |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final int MOUSE_FIRST
public static final int MOUSE_LAST
public static final int MOUSE_CLICKED
MouseEvent
occurs when a mouse button is pressed and released.
public static final int MOUSE_PRESSED
MouseEvent
occurs when a mouse button is pushed down.
public static final int MOUSE_RELEASED
MouseEvent
occurs when a mouse button is let up.
public static final int MOUSE_MOVED
MouseEvent
occurs when the mouse position changes.
public static final int MOUSE_ENTERED
MouseEvent
occurs when the mouse cursor enters the unobscured part of component's
geometry.
public static final int MOUSE_EXITED
MouseEvent
occurs when the mouse cursor exits the unobscured part of component's
geometry.
public static final int MOUSE_DRAGGED
MouseEvent
occurs when the mouse position changes while a mouse button is pressed.
public static final int MOUSE_WHEEL
MouseWheelEvent
.
It occurs when a mouse equipped with a wheel has its wheel rotated.
public static final int NOBUTTON
getButton()
.
public static final int BUTTON1
getButton()
.
public static final int BUTTON2
getButton()
.
public static final int BUTTON3
getButton()
.
Constructor Detail |
---|
public MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger, int button)
MouseEvent
object with the
specified source component,
type, modifiers, coordinates, and click count.
Note that passing in an invalid id
results in
unspecified behavior. Creating an invalid event (such
as by using more than one of the old _MASKs, or modifier/button
values which don't match) results in unspecified behavior.
An invocation of the form
MouseEvent(source, id, when, modifiers, x, y, clickCount, popupTrigger, button)
behaves in exactly the same way as the invocation
MouseEvent
(source, id, when, modifiers,
x, y, xAbs, yAbs, clickCount, popupTrigger, button)
where xAbs and yAbs defines as source's location on screen plus
relative coordinates x and y.
xAbs and yAbs are set to zero if the source is not showing.
This method throws an
IllegalArgumentException
if source
is null
.
source
- the Component
that originated the eventid
- the integer that identifies the eventwhen
- a long int that gives the time the event occurredmodifiers
- the modifier keys down during event (e.g. shift, ctrl,
alt, meta)
Either extended _DOWN_MASK or old _MASK modifiers
should be used, but both models should not be mixed
in one event. Use of the extended modifiers is
preferred.x
- the horizontal x coordinate for the mouse locationy
- the vertical y coordinate for the mouse locationclickCount
- the number of mouse clicks associated with eventpopupTrigger
- a boolean, true if this event is a trigger for a
popup menubutton
- which of the mouse buttons has changed state.
NOBUTTON
,
BUTTON1
,
BUTTON2
or
BUTTON3
.
IllegalArgumentException
- if an invalid button
value is passed in
IllegalArgumentException
- if source
is nullpublic MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger)
MouseEvent
object with the
specified source component,
type, modifiers, coordinates, and click count.
Note that passing in an invalid id
results in
unspecified behavior.
An invocation of the form
MouseEvent(source, id, when, modifiers, x, y, clickCount, popupTrigger)
behaves in exactly the same way as the invocation
MouseEvent
(source, id, when, modifiers,
x, y, xAbs, yAbs, clickCount, popupTrigger, MouseEvent.NOBUTTON)
where xAbs and yAbs defines as source's location on screen plus
relative coordinates x and y.
xAbs and yAbs are set to zero if the source is not showing.
This method throws an IllegalArgumentException
if source
is null
.
source
- the Component
that originated the eventid
- the integer that identifies the eventwhen
- a long int that gives the time the event occurredmodifiers
- the modifier keys down during event (e.g. shift, ctrl,
alt, meta)
Either extended _DOWN_MASK or old _MASK modifiers
should be used, but both models should not be mixed
in one event. Use of the extended modifiers is
preferred.x
- the horizontal x coordinate for the mouse locationy
- the vertical y coordinate for the mouse locationclickCount
- the number of mouse clicks associated with eventpopupTrigger
- a boolean, true if this event is a trigger for a
popup menu
IllegalArgumentException
- if source
is nullpublic MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int xAbs, int yAbs, int clickCount, boolean popupTrigger, int button)
MouseEvent
object with the
specified source component,
type, modifiers, coordinates, absolute coordinates, and click count.
Note that passing in an invalid id
results in
unspecified behavior. Creating an invalid event (such
as by using more than one of the old _MASKs, or modifier/button
values which don't match) results in unspecified behavior.
Even if inconsistent values for relative and absolute coordinates are
passed to the constructor, the mouse event instance is still
created and no exception is thrown.
This method throws an
IllegalArgumentException
if source
is null
.
source
- the Component
that originated the eventid
- the integer that identifies the eventwhen
- a long int that gives the time the event occurredmodifiers
- the modifier keys down during event (e.g. shift, ctrl,
alt, meta)
Either extended _DOWN_MASK or old _MASK modifiers
should be used, but both models should not be mixed
in one event. Use of the extended modifiers is
preferred.x
- the horizontal x coordinate for the mouse locationy
- the vertical y coordinate for the mouse locationxAbs
- the absolute horizontal x coordinate for the mouse locationyAbs
- the absolute vertical y coordinate for the mouse locationclickCount
- the number of mouse clicks associated with eventpopupTrigger
- a boolean, true if this event is a trigger for a
popup menubutton
- which of the mouse buttons has changed state.
NOBUTTON
,
BUTTON1
,
BUTTON2
or
BUTTON3
.
IllegalArgumentException
- if an invalid button
value is passed in
IllegalArgumentException
- if source
is nullMethod Detail |
---|
public Point getLocationOnScreen()
Point
object containing the absolute x
and y coordinates.GraphicsConfiguration
public int getXOnScreen()
GraphicsConfiguration
public int getYOnScreen()
GraphicsConfiguration
public int getX()
public int getY()
public Point getPoint()
Point
object containing the x and y coordinates
relative to the source componentpublic void translatePoint(int x, int y)
x
(horizontal) and y
(vertical) offsets.
x
- the horizontal x value to add to the current x
coordinate positiony
- the vertical y value to add to the current y
coordinate positionpublic int getClickCount()
public int getButton()
NOBUTTON
,
BUTTON1
,
BUTTON2
or
BUTTON3
.public boolean isPopupTrigger()
Note: Popup menus are triggered differently
on different systems. Therefore, isPopupTrigger
should be checked in both mousePressed
and mouseReleased
for proper cross-platform functionality.
public static String getMouseModifiersText(int modifiers)
String
describing the modifier keys and
mouse buttons that were down during the event, such as "Shift",
or "Ctrl+Shift". These strings can be localized by changing
the awt.properties
file.
Note that InputEvent.ALT_MASK
and
InputEvent.BUTTON2_MASK
have the same value,
so the string "Alt" is returned for both modifiers. Likewise,
InputEvent.META_MASK
and
InputEvent.BUTTON3_MASK
have the same value,
so the string "Meta" is returned for both modifiers.
modifiers
- a modifier mask describing the modifier keys and
mouse buttons that were down during the event
InputEvent.getModifiersExText(int)
public String paramString()
paramString
in class ComponentEvent