Google

Main Page   Class Hierarchy   Compound List   File List   Compound Members  

iEventPlug Struct Reference

Event plug interface, also referred as "event source".<. More...

#include <event.h>

Inheritance diagram for iEventPlug:

iBase List of all members.

Public Methods

virtual unsigned GetPotentiallyConflictingEvents ()=0
 Get the mask of events that can be generated by this source and are generated directly from user actions (e.g. More...

virtual unsigned QueryEventPriority (unsigned iType)=0
 Query how strong the plug's wish to generate certain class of events is. More...

virtual void EnableEvents (unsigned, bool)
 Enable or disable certain event class(es).<. More...


Detailed Description

Event plug interface, also referred as "event source".<.

p> This interface should be implemented by any plugin that wants to be able to generate events and to put them into system event queue. The plugin registers itself with an event queue as an event source, and gets a pointer to a new iEventOutlet object which manages event the event flow from this particular event source.


Member Function Documentation

void iEventPlug::EnableEvents ( unsigned,
bool ) [inline, virtual]
 

Enable or disable certain event class(es).<.

p> This is not a mandatory function; in fact most event plugs may safely ignore it. The mean of this function is purely advisory; for example if both keyup and keydown events are disabled the plug may want to release the keyboard and so on.

unsigned iEventPlug::GetPotentiallyConflictingEvents ( ) [pure virtual]
 

Get the mask of events that can be generated by this source and are generated directly from user actions (e.g.

key presses, mouse clicks and so on). This is used to locate potentialy conflicting combinations of event source plugins (for example two event sources may generate a csevKeyDown event each from every key press).

The mask is a combination of CSEVTYPE_XXX values ORed together.

unsigned iEventPlug::QueryEventPriority ( unsigned iType ) [pure virtual]
 

Query how strong the plug's wish to generate certain class of events is.

The plug with the strongest wish wins. The argument is one of CSEVTYPE_XXX values (but never a combination of several OR'ed together).

The typical value is somewhere around 100; the event plugs which are sometimes implemented inside the system drivers (such as for Windows and DJGPP) usually have the priority 100.


The documentation for this struct was generated from the following file:
Generated for Crystal Space by doxygen 1.2.5 written by Dimitri van Heesch, ©1997-2000