openvrml::event_emitter Class Reference

Abstract base class of event emitters. More...

#include <openvrml/event.h>

Inheritance diagram for openvrml::event_emitter:

Public Types
typedef std::set < event_listener * >	listener_set
	Set of event_listeners. More...

Public Member Functions
virtual	~event_emitter ()=0 throw ()
	Destroy. More...
const field_value &	value () const throw ()
	A reference to the field_value for the event_emitter. More...
const std::string	eventout_id () const throw ()
	The associated eventOut identifier. More...
double	last_time () const throw ()
	The timestamp of the last event emitted. More...
template<typename FieldValue >
bool	add (field_value_listener< FieldValue > &listener) throw ( std::bad_alloc )
	Add an event listener. More...
template<typename FieldValue >
bool	remove (field_value_listener< FieldValue > &listener) throw ()
	Remove an event listener. More...

Protected Member Functions
	event_emitter (const field_value &value) throw ()
	Construct. More...
template<typename FieldValue >
const std::set < field_value_listener < FieldValue > * >	listeners () const throw ( std::bad_alloc )
	The event listeners currently listening to the emitter. More...
template<typename FieldValue >
void	emit_event (double timestamp) throw ( std::bad_alloc )
	Emit an event. More...

Private Member Functions
virtual const std::string	do_eventout_id () const =0 throw ()
	The associated eventOut identifier. More...

Detailed Description

Abstract base class of event emitters.

Member Typedef Documentation

openvrml::event_emitter::listener_set

Set of event_listeners.

Constructor & Destructor Documentation

openvrml::event_emitter::~event_emitter ( ) throw ( )

pure virtual

Destroy.

Implemented in openvrml::node_impl_util::abstract_node< Derived >::event_emitter< FieldValue >.

openvrml::event_emitter::event_emitter ( const field_value &  value ) throw ( )

explicitprotected

Construct.

Parameters

[in]

value

field_value associated with this emitter.

Member Function Documentation

const openvrml::field_value & openvrml::event_emitter::value	(		)	const
throw	(
	)

A reference to the field_value for the event_emitter.

Returns

a reference to the field_value for the event_emitter.

const std::string openvrml::event_emitter::eventout_id	(		)	const
throw	(
	)

The associated eventOut identifier.

This function delegates to event_emitter::do_eventout_id.

Returns

the associated eventOut identifier.

double openvrml::event_emitter::last_time	(		)	const
throw	(
	)

The timestamp of the last event emitted.

Returns

the timestamp of the last event emitted.

template<typename FieldValue >

bool openvrml::event_emitter::add	(	field_value_listener< FieldValue > &	listener	)
throw	(	std::bad_alloc
	)

Add an event listener.

Template Parameters

FieldValue

a Field Value.

Parameters

[in]

listener

an event listener.

Exceptions

std::bad_alloc

if memory allocation fails.

template<typename FieldValue >

bool openvrml::event_emitter::remove	(	field_value_listener< FieldValue > &	listener	)
throw	(
	)

Remove an event listener.

Template Parameters

FieldValue

a Field Value.

Parameters

[in]

listener

an event listener.

template<typename FieldValue >

const std::set< field_value_listener< FieldValue > * > openvrml::event_emitter::listeners ( ) const throw ( std::bad_alloc )

protected

The event listeners currently listening to the emitter.

Template Parameters

FieldValue

a Field Value.

Returns

the event listeners currently listening to the emitter.

template<typename FieldValue >

void openvrml::event_emitter::emit_event ( double  timestamp ) throw ( std::bad_alloc )

protected

Emit an event.

Template Parameters

FieldValue

a Field Value.

Parameters

[in]

timestamp

the current time.

Exceptions

std::bad_alloc

if memory allocation fails.

Parameters

[in]

timestamp

the current time.

Exceptions

std::bad_alloc

if memory allocation fails.

This function is called by node::emit_event.

const std::string openvrml::event_emitter::do_eventout_id ( ) const throw ( )

privatepure virtual

The associated eventOut identifier.

Concrete subclasses must implement this function.

Returns

the associated eventOut identifier.

Implemented in openvrml::node_impl_util::event_emitter_base< Node >, and openvrml::node_impl_util::event_emitter_base< Derived >.