#include
<MEvent.h>
List of all
members.
Detailed Description
System event information.
The MEvent class is used for querying
system events such as mouse presses.
Events are handled by an MPxContext derived
class in which MEvents are passed and can be accessed.
Since Maya has default actions for several events, only a subset
are avalaible through the API. The events that can be accessed
are:
- buttonPress - mouse button press event (left &
middle only)
- buttonRelease - mouse buttons release event (left &
middle only)
- mouseDrag - mouse button drag event (left & middle
only)
- hold - mouse button hold event (left & middle
only)
- deleteEvent - delete/backspace key event
- commandCompletion - complete key event
Several modifiers for events are also accessible through the API.
Modifiers are actions that occur during an event. For example,
holding down the shift key while pressing a mouse button causes a
button press event to occur with a shift modifier.
A modifier can be used to determine if two mouse events occur
simulaneously. The second mouse event is registered as a modifier
in the hold event of the first mouse button. So if you wanted to
determine if both the left and middle buttons are pressed then you
would query the modifier in the hold event of the first mouse
button using the isModifierMiddleMouseButton()
and isModifierLeftMouseButton()
methods.
-
componentScaleManip.cpp,
customAttrManip.cpp,
helixTool.cpp, lassoTool.cpp,
marqueeTool.cpp, meshRemapTool.cpp,
meshRemapTool.h,
meshReorderTool.cpp,
meshReorderTool.h,
moveManip.cpp, moveNumericTool.cpp,
moveTool.cpp, rotateManip.cpp, and
surfaceBumpManip.cpp.
Member Enumeration Documentation
Modifier key types.
- Enumerator:
-
Mouse button types.
- Enumerator:
-
Constructor & Destructor Documentation
MEvent::~MEvent |
( |
|
) |
[virtual] |
Member Function Documentation
MStatus MEvent::getPosition |
( |
short & |
x_pos, |
|
|
short & |
y_pos |
|
|
) |
|
|
const |
Get the location of the event in view co-ordinates. The origin
is at the lower left corner of the window.
- Parameters:
-
[out] |
x_pos |
storage for horizonal position |
[out] |
y_pos |
storage for vertical position |
- Returns:
- Status Code
- Status Codes:
-
MStatus MEvent::setPosition |
( |
short |
x_pos, |
|
|
short |
y_pos |
|
|
) |
|
|
|
set the location of the event to the specified location. The
origin is at the lower left corner of the window.
- Parameters:
-
[in] |
x_pos |
horizonal position to set |
[in] |
y_pos |
vertical position to set |
- Returns:
- Status Code
- Status Codes:
-
MStatus MEvent::getWindowPosition |
( |
short & |
x_pos, |
|
|
short & |
y_pos |
|
|
) |
|
|
const |
This routine is used by responders to query the position of the
pointer when the event occurred. It is given in screen
co-ordinates.
The origin is at the upper left corner of the window.
- Parameters:
-
[out] |
x_pos |
storage for horizonal position |
[out] |
y_pos |
storage for vertical position |
- Returns:
- Status Code
- Status Codes:
-
Get the mouse button of the last event.
- Parameters:
-
- Returns:
- Mouse button from last event.
- Status Codes:
-
bool MEvent::isModifierKeyRelease |
( |
MStatus * |
ReturnStatus =
NULL |
) |
const |
Was a modifier key released.
- Parameters:
-
- Returns:
-
- true A modifier key was released.
- false No modifier key was released.
- Status Codes:
-
This routine is used by responders to find the state of the
modifiers during the event.
- Parameters:
-
- Returns:
- Modifier type.
- Status Codes:
-
set the event modifiers.
- Parameters:
-
[in] |
modType |
Type of modifier to set to. |
- Returns:
- Status Code
- Status Codes:
-
bool MEvent::isModifierNone |
( |
MStatus * |
ReturnStatus =
NULL |
) |
const |
Determines if there are any modifiers for this event.
- Parameters:
-
- Returns:
-
- true There are modifiers for this event.
- false There are NO modifiers for this event.
- Status Codes:
-
bool MEvent::isModifierShift |
( |
MStatus * |
ReturnStatus =
NULL |
) |
const |
return state of shift key.
- Parameters:
-
- Returns:
-
- true Shift key triggered this event.
- false The shift key did not cause this event.
- Status Codes:
-
bool MEvent::isModifierControl |
( |
MStatus * |
ReturnStatus =
NULL |
) |
const |
return state of control key.
- Parameters:
-
- Returns:
-
- true Control key triggered this event.
- false The control key did not cause this event.
- Status Codes:
-
bool MEvent::isModifierLeftMouseButton |
( |
MStatus * |
ReturnStatus =
NULL |
) |
const |
Return the state of the left mouse button.
This method is only valid when called in the hold event for
another mouse press.
- Parameters:
-
- Returns:
-
- true Left mouse button triggered this event.
- false The left moust button did not cause this
event.
- Status Codes:
-
bool MEvent::isModifierMiddleMouseButton |
( |
MStatus * |
ReturnStatus =
NULL |
) |
const |
Return the state of the middle mouse button.
This method is only valid when called in the hold event for
another mouse press.
- Parameters:
-
- Returns:
-
- true Middle mouse button triggered this event.
- false The middle moust button did not cause this
event.
- Status Codes:
-