|
Préférences
Moteurs de recherche
|
||||||||||||||||||||||||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
java.awt.event
|
Field Summary | |
---|---|
static int |
WHEEL_BLOCK_SCROLL
Constant representing scrolling by a "block" (like scrolling with page-up, page-down keys) |
static int |
WHEEL_UNIT_SCROLL
Constant representing scrolling by "units" (like scrolling with the arrow keys) |
Fields inherited from class java.awt.event.MouseEvent |
---|
BUTTON1, BUTTON2, BUTTON3, MOUSE_CLICKED, MOUSE_DRAGGED, MOUSE_ENTERED, MOUSE_EXITED, MOUSE_FIRST, MOUSE_LAST, MOUSE_MOVED, MOUSE_PRESSED, MOUSE_RELEASED, MOUSE_WHEEL, NOBUTTON |
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 | |
---|---|
MouseWheelEvent(Component source,
int id,
long when,
int modifiers,
int x,
int y,
int clickCount,
boolean popupTrigger,
int scrollType,
int scrollAmount,
int wheelRotation)
Constructs a MouseWheelEvent object with the
specified source component, type, modifiers, coordinates,
scroll type, scroll amount, and wheel rotation. |
|
MouseWheelEvent(Component source,
int id,
long when,
int modifiers,
int x,
int y,
int xAbs,
int yAbs,
int clickCount,
boolean popupTrigger,
int scrollType,
int scrollAmount,
int wheelRotation)
Constructs a MouseWheelEvent object with the
specified source component, type, modifiers, coordinates,
absolute coordinates, scroll type, scroll amount, and wheel rotation. |
Method Summary | |
---|---|
int |
getScrollAmount()
Returns the number of units that should be scrolled per click of mouse wheel rotation. |
int |
getScrollType()
Returns the type of scrolling that should take place in response to this event. |
int |
getUnitsToScroll()
This is a convenience method to aid in the implementation of the common-case MouseWheelListener - to scroll a ScrollPane or JScrollPane by an amount which conforms to the platform settings. |
int |
getWheelRotation()
Returns the number of "clicks" the mouse wheel was rotated. |
String |
paramString()
Returns a parameter string identifying this event. |
Methods inherited from class java.awt.event.MouseEvent |
---|
getButton, getClickCount, getLocationOnScreen, getMouseModifiersText, getPoint, getX, getXOnScreen, getY, getYOnScreen, isPopupTrigger, translatePoint |
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 WHEEL_UNIT_SCROLL
getScrollType()
,
Constant Field Valuespublic static final int WHEEL_BLOCK_SCROLL
getScrollType()
,
Constant Field ValuesConstructor Detail |
---|
public MouseWheelEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger, int scrollType, int scrollAmount, int wheelRotation)
MouseWheelEvent
object with the
specified source component, type, modifiers, coordinates,
scroll type, scroll amount, and wheel rotation.
Absolute coordinates xAbs and yAbs are set to source's location on screen plus relative coordinates x and y. xAbs and yAbs are set to zero if the source is not showing.
Note that passing in an invalid id
results in
unspecified behavior. This method throws an
IllegalArgumentException
if source
is null
.
source
- the Component
that originated
the eventid
- the integer that identifies the eventwhen
- a long that gives the time the event occurredmodifiers
- the modifier keys down during event
(shift, ctrl, alt, meta)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-menuscrollType
- the type of scrolling which should take place in
response to this event; valid values are
WHEEL_UNIT_SCROLL
and
WHEEL_BLOCK_SCROLL
scrollAmount
- for scrollType WHEEL_UNIT_SCROLL
,
the number of units to be scrolledwheelRotation
- the amount that the mouse wheel was rotated (the
number of "clicks")
IllegalArgumentException
- if source
is nullMouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean)
,
MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, int, int, boolean, int)
public MouseWheelEvent(Component source, int id, long when, int modifiers, int x, int y, int xAbs, int yAbs, int clickCount, boolean popupTrigger, int scrollType, int scrollAmount, int wheelRotation)
MouseWheelEvent
object with the
specified source component, type, modifiers, coordinates,
absolute coordinates, scroll type, scroll amount, and wheel rotation.
Note that passing in an invalid id
results in
unspecified behavior. This method throws an
IllegalArgumentException
if source
is null
.
Even if inconsistent values for relative and absolute coordinates are passed to the constructor, the MouseWheelEvent instance is still created and no exception is thrown.
source
- the Component
that originated
the eventid
- the integer that identifies the eventwhen
- a long that gives the time the event occurredmodifiers
- the modifier keys down during event
(shift, ctrl, alt, meta)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-menuscrollType
- the type of scrolling which should take place in
response to this event; valid values are
WHEEL_UNIT_SCROLL
and
WHEEL_BLOCK_SCROLL
scrollAmount
- for scrollType WHEEL_UNIT_SCROLL
,
the number of units to be scrolledwheelRotation
- the amount that the mouse wheel was rotated (the
number of "clicks")
IllegalArgumentException
- if source
is nullMouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean)
,
MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, int, int, boolean, int)
Method Detail |
---|
public int getScrollType()
Adjustable.getUnitIncrement()
,
Adjustable.getBlockIncrement()
,
Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)
,
Scrollable.getScrollableBlockIncrement(java.awt.Rectangle, int, int)
public int getScrollAmount()
getScrollType
returns
MouseWheelEvent.WHEEL_UNIT_SCROLL
getScrollType
returns
MouseWheelEvent.WHEEL_BLOCK_SCROLL
getScrollType()
public int getWheelRotation()
public int getUnitsToScroll()
ScrollPane
and
JScrollPane
already have this functionality built in.)
This method returns the number of units to scroll when scroll type is
MouseWheelEvent.WHEEL_UNIT_SCROLL, and should only be called if
getScrollType
returns MouseWheelEvent.WHEEL_UNIT_SCROLL.
Direction of scroll, amount of wheel movement, and platform settings for wheel scrolling are all accounted for. This method does not and cannot take into account value of the Adjustable/Scrollable unit increment, as this will vary among scrolling components.
A simplified example of how this method might be used in a listener:
mouseWheelMoved(MouseWheelEvent event) { ScrollPane sp = getScrollPaneFromSomewhere(); Adjustable adj = sp.getVAdjustable() if (MouseWheelEvent.getScrollType() == WHEEL_UNIT_SCROLL) { int totalScrollAmount = event.getUnitsToScroll() * adj.getUnitIncrement(); adj.setValue(adj.getValue() + totalScrollAmount); } }
getScrollType()
,
getScrollAmount()
,
MouseWheelListener
,
Adjustable
,
Adjustable.getUnitIncrement()
,
Scrollable
,
Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)
,
ScrollPane
,
ScrollPane.setWheelScrollingEnabled(boolean)
,
JScrollPane
,
JScrollPane.setWheelScrollingEnabled(boolean)
public String paramString()
paramString
in class MouseEvent