X event interface to the Alias API. ( This class is not available on NT.)
Synopsis
#include <AlXevents.h>
class AlXevents
static statusCode installHandler( int (*)( XEvent* ) );
static statusCode uninstallHandler( int (*)( XEvent* ) );
static XtAppContext getXtAppContext( void );
static Widget getAppShell( void );
static statusCode addXdevice( const char *, int (*)(Widget, XDeviceInfoPtr) );
static statusCode getXdevID( const char *, int& );
static statusCode getXdevType( const char *, const char *, int& );
static statusCode getXdevice( const char *, XDevice ** );
static statusCode addXdevID( const char *, XDevice *, int );
static statusCode addXdevType( char *, const char *, int, int );
static statusCode applicationNotify();
static boolean belowAliasWindow( Widget );
Description
This static class contains methods to handle custom X event handling in the Alias API.
statusCode AlXevents::applicationNotify()
Description
Called by an interrupt handler to notify Alias that the handler has serviced the interrupt.
statusCode AlXevents::installHandler( int (*func)( XEvent* ) )
Description
Adds a callback handler for X events. The handler function will be passed every X event before Alias handles it. If the callback handler returns 0, then Alias will ignore the event. If it returns 1, then Alias will handle the event normally.
Arguments
func - callback pointer
Return Codes
sInvalidArgument - ’func’ was NULL
sSuccess - the event handler was installed
sFailure - the event handler was not installed
statusCode AlXevents::uninstallHandler( int (*func)( XEvent* ) )
Description
Removes a callback handler for X events.
Arguments
func - callback pointer to an installed handler
Return Codes
sInvalidArgument - ’func’ was NULL
sSuccess - the event handler was uninstalled
sFailure - the event handler could not be found
XtAppContext AlXevents::getXtAppContext( void )
Description
Returns Alias’ XtAppContext.
Widget AlXevents::getAppShell( void )
Description
Returns the application shell widget used by Alias. This widget should be used as a top level shell when creating custom dialog widgets for user interface interaction. Alias is responsible for processing and dispatching all events.
statusCode AlXevents::addXdevice( const char * name,int (*devXopen)(Widget, XDeviceInfoPtr) )
Description
Adds the named X device to the list of Alias devices.
Arguments
< name - the name of the device
< devXopen - function to call on opening of device
Return Codes
sInvalidArgument - name was NULL
sSuccess - the value was returned
sFailure - the variable could not be found
statusCode AlXevents::getXdevID( const char * dev, int& value )
Description
Retrieves the value of the named device from the Alias device list.
Arguments
< name - the name of the device
> value - the returned value
Return Codes
sInvalidArgument - name was NULL
sSuccess - the value was returned
sFailure - the variable could not be found
statusCode AlXevents::getXdevType( const char * dev, const char * event, int& value )
Description
Retrieves the value of the named device event from the Alias device list.
Arguments
< name - the name of the device
< event - the name of the event ID wanted
> value - the returned value
Return Codes
sInvalidArgument - name was NULL
sSuccess - the value was returned
sFailure - the variable could not be found
statusCode AlXevents::getXdevice( const char * dev, XDevice **xdev )
Description
Retrieves the value of the named device from the Alias device list.
Arguments
< name - the name of the device
> xdev - pointer to the XDevice structure
Return Codes
sInvalidArgument - name was NULL
sSuccess - the value was returned
sFailure - the variable could not be found
statusCode AlXevents::addXdevID( const char *name, XDevice *xdev, int dev_id )
Description
Adds the named device to the Alias device list.
Arguments
< name - the name of the device
< xdev - pointer to the XDevice structure
< dev_id - X device ID
Return Codes
sInvalidArgument - name was NULL
sSuccess - the value was returned
sFailure - the variable could not be found
statusCode AlXevents::addXdevType( char *name, const char *type,int type_id, int class_id )
Description
Adds the named device event to the Alias device list.
Arguments
< name - the name of the device
< event - the name of the event ID wanted
< type id - the event type to add
< class id - the event class to add
Return Codes
sInvalidArgument - name was NULL
sSuccess - the value was returned
sFailure - the variable could not be found
boolean AlXevents::belowAliasWindow( Widget w )
Description
Returns TRUE if Widget w is lower than the Alias window. Otherwise FALSE is returned.
