SoSpaceballButtonEvent Class Reference

The SoSpaceballButtonEvent class contains information about spaceball button interaction. More...

#include <Inventor/events/SoSpaceballButtonEvent.h>

Inheritance diagram for SoSpaceballButtonEvent:

Public Types
enum	Button {   ANY , BUTTON1 , BUTTON2 , BUTTON3 ,   BUTTON4 , BUTTON5 , BUTTON6 , BUTTON7 ,   BUTTON8 , PICK }
Public Types inherited from SoButtonEvent
enum	State { UP , DOWN , UNKNOWN }

Public Member Functions
	SoSpaceballButtonEvent (void)
virtual	~SoSpaceballButtonEvent ()
Button	getButton (void) const
virtual SoType	getTypeId (void) const
void	setButton (Button button)
Public Member Functions inherited from SoButtonEvent
	SoButtonEvent (void)
virtual	~SoButtonEvent ()
State	getState (void) const
void	setState (State state)
Public Member Functions inherited from SoEvent
	SoEvent (void)
virtual	~SoEvent ()
const SbVec2f &	getNormalizedPosition (const SbViewportRegion &vpRgn) const
const SbVec2s &	getPosition (const SbViewportRegion &vpRgn) const
const SbVec2s &	getPosition (void) const
SbTime	getTime (void) const
SbBool	isOfType (SoType type) const
void	setAltDown (SbBool isDown)
void	setCtrlDown (SbBool isDown)
void	setPosition (const SbVec2s &p)
void	setShiftDown (SbBool isDown)
void	setTime (const SbTime t)
SbBool	wasAltDown (void) const
SbBool	wasCtrlDown (void) const
SbBool	wasShiftDown (void) const

Static Public Member Functions
static SbBool	enumToString (Button enumval, SbString &stringrep)
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 Public Member Functions inherited from SoButtonEvent
static SbBool	enumToString (State enumval, SbString &stringrep)
static SoType	getClassTypeId (void)
static void	initClass (void)
Static Public Member Functions inherited from SoEvent
static SoType	getClassTypeId (void)
static void	initClass (void)

Detailed Description

The SoSpaceballButtonEvent class contains information about spaceball button interaction.

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

See also

SoEvent, SoButtonEvent, SoMouseButtonEvent, SoKeyboardEvent

SoEventCallback, SoHandleEventAction

Member Enumeration Documentation

Button

enum SoSpaceballButtonEvent::Button

This enum contains all spaceball buttons detected by Coin.

Enumerator
ANY	Any of the buttons.
BUTTON1	Spaceball button 1.
BUTTON2	Spaceball button 2.
BUTTON3	Spaceball button 3.
BUTTON4	Spaceball button 4.
BUTTON5	Spaceball button 5.
BUTTON6	Spaceball button 6.
BUTTON7	Spaceball button 7.
BUTTON8	Spaceball button 8.
PICK	Spaceball pick button.

Constructor & Destructor Documentation

SoSpaceballButtonEvent()

SoSpaceballButtonEvent::SoSpaceballButtonEvent

(

void

)

Constructor.

~SoSpaceballButtonEvent()

SoSpaceballButtonEvent::~SoSpaceballButtonEvent ( )

virtual

Destructor.

Member Function Documentation

enumToString()

SbBool SoSpaceballButtonEvent::enumToString ( Button enumval, SbString & stringrep )

static

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

getButton()

SoSpaceballButtonEvent::Button SoSpaceballButtonEvent::getButton

(

void

)

const

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

See also

getState()

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

getClassTypeId()

SoType SoSpaceballButtonEvent::getClassTypeId ( void )

static

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

getTypeId()

SoType SoSpaceballButtonEvent::getTypeId ( void ) const

virtual

Returns the type identification of an object derived from a class inheriting SoEvent. This is used for runtime type checking and "downward" casting.

Reimplemented from SoButtonEvent.

initClass()

void SoSpaceballButtonEvent::initClass ( void )

static

Initialize the type information data.

isButtonPressEvent()

SbBool SoSpaceballButtonEvent::isButtonPressEvent ( const SoEvent * e, SoSpaceballButtonEvent::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()

isButtonReleaseEvent()

SbBool SoSpaceballButtonEvent::isButtonReleaseEvent ( const SoEvent * e, SoSpaceballButtonEvent::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()

setButton()

void SoSpaceballButtonEvent::setButton

(

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

---

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

• SoSpaceballButtonEvent.h
• SoSpaceballButtonEvent.cpp