SoWin
1.6.2
Coin3D GUI toolkit binding
|
The SoWinMouse class is the mouse input device abstraction. More...
#include <Inventor/Win/devices/SoWinMouse.h>
Public Types | |
enum | Events { BUTTON_PRESS = 0x01 , BUTTON_RELEASE = 0x02 , POINTER_MOTION = 0x04 , BUTTON_MOTION = 0x08 , ALL_EVENTS = BUTTON_PRESS | BUTTON_RELEASE | POINTER_MOTION | BUTTON_MOTION } |
Public Member Functions | |
SoWinMouse (int eventmask=ALL_EVENTS) | |
virtual | ~SoWinMouse (void) |
virtual void | disable (HWND widget, SoWinEventHandler *handler, void *closure) |
virtual void | enable (HWND widget, SoWinEventHandler *handler, void *closure) |
virtual const SoEvent * | translateEvent (MSG *event) |
Public Member Functions inherited from SoWinDevice | |
virtual | ~SoWinDevice () |
SbVec2s | getWindowSize (void) const |
void | setWindowSize (const SbVec2s size) |
Public Member Functions inherited from SoWinObject | |
virtual SoType | getTypeId (void) const =0 |
SbBool | isOfType (SoType type) const |
Additional Inherited Members | |
Static Public Member Functions inherited from SoWinDevice | |
static void | initClasses (void) |
Static Public Member Functions inherited from SoWinObject | |
static SoType | getClassTypeId (void) |
static void | init (void) |
static void | initClass (void) |
Protected Member Functions inherited from SoWinDevice | |
SoWinDevice (void) | |
void | addEventHandler (HWND, SoWinEventHandler *, void *) |
void | invokeHandlers (MSG *event) |
void | removeEventHandler (HWND, SoWinEventHandler *, void *) |
void | setEventPosition (SoEvent *event, int x, int y) const |
Static Protected Member Functions inherited from SoWinDevice | |
static SbVec2s | getLastEventPosition (void) |
The SoWinMouse class is the mouse input device abstraction.
The SoWinMouse class is the glue between native mouse handling and mouse interaction in the Inventor scene graph.
All components derived from the SoWinRenderArea have got an SoWinMouse device attached by default.
One important note for application programmers: our mappings to SoMouseButtonEvent::BUTTON2 and SoMouseButtonEvent::BUTTON3 do not match the mappings in SGI's InventorXt library or TGS's SoWin library for 3-button mice. They map mouse buttons like this:
While in this SIM SoWin library the mappings are:
This is a conscious design decision we've made. The reason is that BUTTON2 should be the right mouse button whether you have a 2-button mouse or a 3-button mouse.
enum SoWinMouse::Events |
Enumeration over supported mouse events.
SoWinMouse::SoWinMouse | ( | int | mask = ALL_EVENTS | ) |
Constructor. The mask argument should contain the set of SoWinMouse::Events one is interested in tracking.
|
virtual |
Destructor.
|
virtual |
This method will disable the handler for the device.
Implements SoWinDevice.
|
virtual |
This method will enable the device for the widget.
handler is invoked with the closure argument when an event occur in widget.
Implements SoWinDevice.
|
virtual |
Translates a native event from the underlying toolkit into a generic event.
This is then returned in the form of an instance of a subclass of the Inventor API's SoEvent class, either an SoMouseButtonEvent or an SoLocation2Event, depending on whether the native event is a mouse button press / release, or a mouse cursor movement event.
The mapping of the mouse buttons upon generation of SoMouseButtonEvent events will be done as follows:
Note that the rightmost mouse button will always map to SoMouseButtonEvent::BUTTON2, even on a 3-button mouse.
Implements SoWinDevice.