crystalspace.jbind.interfaces.iutil.event
Interface iEventPlug

All Superinterfaces:

iJPointer

All Known Implementing Classes:

csEventPlug

public interface iEventPlug

extends iJPointer

Event plug interface, also referred as "event source". 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.

Author:

Java wrapper - Quentin Anciaux, c++ version - http://crystal.sourceforge.net/docs/online/devapi/structiEventPlug.php

Method Summary

void	enableEvents(int i, boolean b) Enable or disable certain event class(es);.
int	getPotentiallyConflictingEvents() 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);.
int	queryEventPriority(int iType) Query how strong the plug's wish to generate certain class of events is.

Method Detail

enableEvents

public void enableEvents(int i,
                         boolean b)

Enable or disable certain event class(es);. 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. Definition at line 344 of file event.h.

Parameters:

i -

b -

getPotentiallyConflictingEvents

public int getPotentiallyConflictingEvents()

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. Implemented in csGraphics2DAA, csGraphics2DGLCommon, csGraphics2DSDL, csGraphics2DXLib, and csGraphics2DSVGALib.

Returns:

queryEventPriority

public int queryEventPriority(int iType)

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. Implemented in csGraphics2DAA, csGraphics2DGLCommon, csGraphics2DSDL, csGraphics2DXLib, and csGraphics2DSVGALib

Parameters:

iType -

Returns: