Coin Logo http://www.sim.no
http://www.coin3d.org

SoMouseButtonEvent Class Reference
[Event classes]

The SoMouseButtonEvent class contains information about mousebutton interaction.

When the user presses any buttons on the mouse, these will be translated from a system specific event into a Coin event and sent to the scenegraph by using instances of this class. More...

#include <Inventor/events/SoMouseButtonEvent.h>

Inheritance diagram for SoMouseButtonEvent:

SoButtonEvent SoEvent

List of all members.

Public Types

enum  Button {
  ANY, BUTTON1, BUTTON2, BUTTON3,
  BUTTON4, BUTTON5
}

Public Member Functions

virtual SoType getTypeId (void) const
 SoMouseButtonEvent (void)
virtual ~SoMouseButtonEvent ()
void setButton (SoMouseButtonEvent::Button button)
SoMouseButtonEvent::Button getButton (void) const

Static Public Member Functions

static SoType getClassTypeId (void)
static SbBool isButtonPressEvent (const SoEvent *e, SoMouseButtonEvent::Button whichButton)
static SbBool isButtonReleaseEvent (const SoEvent *e, SoMouseButtonEvent::Button whichButton)
static void initClass (void)


Detailed Description

The SoMouseButtonEvent class contains information about mousebutton interaction.

When the user presses any buttons on the mouse, these will be translated from a system specific event into a Coin event and sent to the scenegraph by using instances of this class.

See also:
SoEvent, SoButtonEvent, SoSpaceballButtonEvent, SoKeyboardEvent

SoEventCallback, SoHandleEventAction


Member Enumeration Documentation

This enum contains all mouse buttons detected by Coin.

Enumerator:
ANY  Unknown button.
BUTTON1  First mouse button (usually the leftmost button).
BUTTON2  Second mouse button (usually the middle button).
BUTTON3  Third mouse button (usually the rightmost button).
BUTTON4  Fourth mouse button (typically from a wheelmouse). This is not part of the original Open Inventor API.
BUTTON5  Fifth mouse button (typically from a wheelmouse). This is not part of the original Open Inventor API.


Constructor & Destructor Documentation

SoMouseButtonEvent::SoMouseButtonEvent ( void   ) 

Constructor.

References ANY.

SoMouseButtonEvent::~SoMouseButtonEvent (  )  [virtual]

Destructor.


Member Function Documentation

SoType SoMouseButtonEvent::getClassTypeId ( void   )  [static]

This static method returns the SoType object associated with objects of this class.

Reimplemented from SoButtonEvent.

Referenced by SoWWWAnchor::handleEvent(), SoVRMLAnchor::handleEvent(), isButtonPressEvent(), and isButtonReleaseEvent().

SoType SoMouseButtonEvent::getTypeId ( void   )  const [virtual]

Returns the actual type id of an instantiated object.

Reimplemented from SoButtonEvent.

void SoMouseButtonEvent::setButton ( SoMouseButtonEvent::Button  buttonarg  ) 

Set the value of the button which the user interacted with.

This method is used from the window specific device classes when translating events to the generic Coin library.

See also:
getButton()

SoMouseButtonEvent::Button SoMouseButtonEvent::getButton ( void   )  const

Returns the value of the button which was pressed or released.

See also:
getState()

wasShiftDown(), wasCtrlDown(), wasAltDown(), getPosition(), getTime()

Referenced by isButtonPressEvent(), and isButtonReleaseEvent().

SbBool SoMouseButtonEvent::isButtonPressEvent ( const SoEvent e,
SoMouseButtonEvent::Button  whichButton 
) [static]

Convenience method for quickly checking if the given event is a press on the given button, whichButton.

See also:
isButtonReleaseEvent(), isOfType(), getButton(), getState()

References ANY, SoButtonEvent::DOWN, getButton(), getClassTypeId(), SoButtonEvent::getState(), and SoEvent::isOfType().

Referenced by SoWWWAnchor::handleEvent(), and SoVRMLAnchor::handleEvent().

SbBool SoMouseButtonEvent::isButtonReleaseEvent ( const SoEvent e,
SoMouseButtonEvent::Button  whichButton 
) [static]

Convenience method for quickly checking if the given event is a release of the given button, whichButton.

See also:
isButtonPressEvent(), isOfType(), getButton(), getState()

References ANY, getButton(), getClassTypeId(), SoButtonEvent::getState(), SoEvent::isOfType(), and SoButtonEvent::UP.

void SoMouseButtonEvent::initClass ( void   )  [static]

Initialize the type information data.

Reimplemented from SoButtonEvent.


The documentation for this class was generated from the following files:

Copyright © 1998-2007 by Systems in Motion AS. All rights reserved.

Generated on Mon Feb 23 16:33:54 2009 for Coin by Doxygen. 1.5.8