2002-09-13 Michael Meeks <michael@ximian.com>
[platform/core/uifw/at-spi2-atk.git] / 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 } AccessibleKeyEventType;
47
48
49 typedef struct {
50   long                   keyID;
51   short                  keycode;
52   char *                 keystring;
53   long                   timestamp;
54   AccessibleKeyEventType type;
55   unsigned short         modifiers;
56   SPIBoolean             is_text;       
57 } AccessibleKeystroke;
58
59 /*
60  * Function prototype typedefs for Event Listener Callbacks.
61  * (see libspi/accessibleeventlistener.h for definition of SpiVoidEventListenerCB).
62  *
63  * usage: signatures should be
64  * void (*AccessibleEventListenerCB) (AccessibleEvent *event);
65  *
66  * SPIBoolean (*AccessibleKeystrokeListenerCB) (AccessibleKeystrokeEvent *Event);
67  */
68 typedef void       (*AccessibleEventListenerCB)     (const AccessibleEvent     *event,
69                                                      void                      *user_data);
70 typedef SPIBoolean (*AccessibleKeystrokeListenerCB) (const AccessibleKeystroke *stroke,
71                                                      void                      *user_data);
72
73 #ifdef  __cplusplus
74 }
75 #endif
76
77 #endif