cspi/spi-listener.h

   1 /*
   2  * AT-SPI - Assistive Technology Service Provider Interface
   3  * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap)
   4  *
   5  * Copyright 2001, 2002 Sun Microsystems Inc.,
   6  * Copyright 2001, 2002 Ximian, Inc.
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Library General Public
  10  * License as published by the Free Software Foundation; either
  11  * version 2 of the License, or (at your option) any later version.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Library General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Library General Public
  19  * License along with this library; if not, write to the
  20  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  21  * Boston, MA 02111-1307, USA.
  22  */
  23
  24 #ifndef _SPI_LISTENER_H_
  25 #define _SPI_LISTENER_H_
  26
  27 #include <cspi/spi-impl.h>
  28
  29 #ifdef  __cplusplus
  30 extern "C" {
  31 #endif
  32
  33 /*
  34  * Structure used to encapsulate event information
  35  */
  36 typedef struct {
  37   const char  *type;
  38   Accessible  *source;
  39   long         detail1;
  40   long         detail2;
  41 } AccessibleEvent;
  42
  43 typedef enum {
  44   SPI_KEY_PRESSED  = 1<<0,
  45   SPI_KEY_RELEASED = 1<<1,
  46   SPI_BUTTON_PRESSED = 1<<2,
  47   SPI_BUTTON_RELEASED = 1<<3
  48 } AccessibleDeviceEventType;
  49
  50 typedef AccessibleDeviceEventType AccessibleKeyEventType;
  51
  52 typedef struct {
  53   long                   keyID;
  54   short                  keycode;
  55   char *                 keystring;
  56   long                   timestamp;
  57   AccessibleDeviceEventType type;
  58   unsigned short         modifiers;
  59   SPIBoolean             is_text;
  60 } AccessibleDeviceEvent;
  61
  62 typedef AccessibleDeviceEvent AccessibleKeystroke;
  63
  64 /*
  65  * Function prototype typedefs for Event Listener Callbacks.
  66  * (see libspi/accessibleeventlistener.h for definition of SpiVoidEventListenerCB).
  67  *
  68  * usage: signatures should be
  69  * void (*AccessibleEventListenerCB) (AccessibleEvent *event);
  70  *
  71  * SPIBoolean (*AccessibleKeystrokeListenerCB) (AccessibleKeystrokeEvent *Event);
  72  */
  73 typedef void       (*AccessibleEventListenerCB)     (const AccessibleEvent     *event,
  74                                                      void                      *user_data);
  75 typedef SPIBoolean (*AccessibleKeystrokeListenerCB) (const AccessibleKeystroke *stroke,
  76                                                      void                      *user_data);
  77 typedef SPIBoolean (*AccessibleDeviceListenerCB)    (const AccessibleDeviceEvent *stroke,
  78                                                      void                      *user_data);
  79
  80 #ifdef  __cplusplus
  81 }
  82 #endif
  83
  84 #endif