SimTK::HandleEventsResults Class Reference

Results returned by the handleEvent() method. More...

#include <Event.h>

List of all members.

Public Types
enum	Status {   Invalid = -1,   Succeeded = 0,   ShouldTerminate = 1,   Failed = 2 }
Public Member Functions
	HandleEventsResults ()
HandleEventsResults &	clear ()
	Restore this object to its default-constructed state, with the return status set to Invalid.
bool	isValid () const
Status	getExitStatus () const
bool	getAnyChangeMade () const
Stage	getLowestModifiedStage () const
const String &	getMessage () const
HandleEventsResults &	setExitStatus (Status status)
HandleEventsResults &	setAnyChangeMade (bool changeMade)
HandleEventsResults &	setLowestModifiedStage (Stage stage)
HandleEventsResults &	setMessage (const String &message)

---

Detailed Description

Results returned by the handleEvent() method.

In addition to return status, this records the lowest stage in the state that was modified by the handler. The caller can use this to determine how much reinitialization is required before time stepping can proceed.

---

Member Enumeration Documentation

enum SimTK::HandleEventsResults::Status

Enumerator:

Invalid	This object has not been filled in yet and holds no results.
Succeeded	The handleEvent() operation was successful and time stepping may continue.
ShouldTerminate	The handleEvent() call was successful but the event requires time stepping to terminate. An explanation may have been placed in the message argument.
Failed	The handleEvent() call was unable to successfully handle the event. This is likely to be a fatal error. A human-readable explanation is in the message argument.

---

Constructor & Destructor Documentation

SimTK::HandleEventsResults::HandleEventsResults

(

)

[inline]

---

Member Function Documentation

HandleEventsResults& SimTK::HandleEventsResults::clear

(

)

[inline]

Restore this object to its default-constructed state, with the return status set to Invalid.

bool SimTK::HandleEventsResults::isValid

(

)

const [inline]

Status SimTK::HandleEventsResults::getExitStatus

(

)

const [inline]

bool SimTK::HandleEventsResults::getAnyChangeMade

(

)

const [inline]

Stage SimTK::HandleEventsResults::getLowestModifiedStage

(

)

const [inline]

const String& SimTK::HandleEventsResults::getMessage

(

)

const [inline]

HandleEventsResults& SimTK::HandleEventsResults::setExitStatus

(

Status

status

)

[inline]

HandleEventsResults& SimTK::HandleEventsResults::setAnyChangeMade

(

bool

changeMade

)

[inline]

HandleEventsResults& SimTK::HandleEventsResults::setLowestModifiedStage

(

Stage

stage

)

[inline]

HandleEventsResults& SimTK::HandleEventsResults::setMessage

(

const String &

message

)

[inline]

---

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

• Event.h