SYNOPSIS

#include <Inventor/events/SoMouseButtonEvent.h>

Inherits SoButtonEvent.

Public Types

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

Public Member Functions

virtual SoType getTypeId (void) const

SoMouseButtonEvent (void)

virtual ~SoMouseButtonEvent ()

void setButton (Button button)

Button getButton (void) const

Static Public Member Functions

static SoType getClassTypeId (void)

static void initClass (void)

static SbBool isButtonPressEvent (const SoEvent *e, Button whichButton)

static SbBool isButtonReleaseEvent (const SoEvent *e, Button whichButton)

static SbBool enumToString (Button enumval, SbString &stringrep)

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

enum \fBSoMouseButtonEvent::Button\fP

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.

SoMouseButtonEvent::~SoMouseButtonEvent ()\fC [virtual]\fP

Destructor.

Member Function Documentation

\fBSoType\fP SoMouseButtonEvent::getTypeId (void) const\fC [virtual]\fP

Returns the actual type id of an instantiated object.

Reimplemented from SoButtonEvent.

void SoMouseButtonEvent::initClass (void)\fC [static]\fP

Initialize the type information data.

void SoMouseButtonEvent::setButton (\fBSoMouseButtonEvent::Button\fPbuttonarg)

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()

\fBSoMouseButtonEvent::Button\fP SoMouseButtonEvent::getButton (void) const

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

See also:

getState()

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

SbBool SoMouseButtonEvent::isButtonPressEvent (const \fBSoEvent\fP *e, \fBSoMouseButtonEvent::Button\fPwhichButton)\fC [static]\fP

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

See also:

isButtonReleaseEvent(), isOfType(), getButton(), getState()

SbBool SoMouseButtonEvent::isButtonReleaseEvent (const \fBSoEvent\fP *e, \fBSoMouseButtonEvent::Button\fPwhichButton)\fC [static]\fP

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

See also:

isButtonPressEvent(), isOfType(), getButton(), getState()

SbBool SoMouseButtonEvent::enumToString (\fBButton\fPenumval, \fBSbString\fP &stringrep)\fC [static]\fP

Converts from an enum value of type SoMouseButtonEvent::Button to a string containing the enum symbol.

This function is an extension for Coin, and it is not available in the original SGI Open Inventor v2.1 API.

Since:

Coin 3.0

Author

Generated automatically by Doxygen for Coin from the source code.