![]() |
![]() |
![]() |
libatspi Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
GType atspi_key_definition_get_type (); gint atspi_get_desktop_count (); AtspiAccessible * atspi_get_desktop (gint i
); GArray * atspi_get_desktop_list (); gboolean atspi_register_keystroke_listener (AtspiDeviceListener *listener
,GArray *key_set
,AtspiKeyMaskType modmask
,AtspiKeyEventMask event_types
,gint sync_type
,GError **error
); gboolean atspi_deregister_keystroke_listener (AtspiDeviceListener *listener
,GArray *key_set
,AtspiKeyMaskType modmask
,AtspiKeyEventMask event_types
,GError **error
); gboolean atspi_register_device_event_listener (AtspiDeviceListener *listener
,AtspiDeviceEventMask event_types
,void *filter
,GError **error
); gboolean atspi_deregister_device_event_listener (AtspiDeviceListener *listener
,void *filter
,GError **error
); gboolean atspi_generate_keyboard_event (glong keyval
,const gchar *keystring
,AtspiKeySynthType synth_type
,GError **error
); gboolean atspi_generate_mouse_event (glong x
,glong y
,const gchar *name
,GError **error
);
gint atspi_get_desktop_count ();
Get the number of virtual desktops. NOTE: currently multiple virtual desktops are not implemented, this function always returns '1'.
Returns : |
an integer indicating the number of active virtual desktops. |
AtspiAccessible * atspi_get_desktop (gint i
);
Get the virtual desktop indicated by index i
.
NOTE: currently multiple virtual desktops are not implemented.
|
an integer indicating which of the accessible desktops is to be returned. |
Returns : |
a pointer to the 'i-th' virtual desktop's AtspiAccessible representation. [transfer full] |
GArray * atspi_get_desktop_list ();
Get the list of virtual desktops. On return, list
will point
to a newly-created, NULL terminated array of virtual desktop
pointers.
It is the responsibility of the caller to free this array when
it is no longer needed.
Not Yet Implemented : this implementation always returns a single Accessible desktop.
Returns : |
a GArray of desktops. [transfer full] |
gboolean atspi_register_keystroke_listener (AtspiDeviceListener *listener
,GArray *key_set
,AtspiKeyMaskType modmask
,AtspiKeyEventMask event_types
,gint sync_type
,GError **error
);
Register a listener for keystroke events, either pre-emptively for
all windows (ATSPI_KEYLISTENER_ALL_WINDOWS),
non-preemptively (ATSPI_KEYLISTENER_NOSYNC), or
pre-emptively at the toolkit level (ATSPI_KEYLISTENER_CANCONSUME).
If ALL_WINDOWS or CANCONSUME are used, the event is consumed
upon receipt if one of listener
's callbacks returns TRUE.
( Other sync_type values may be available in the future )
|
a pointer to the AtspiDeviceListener for which keystroke events are requested. |
|
a pointer to the
AtspiKeyDefinition array indicating which keystroke events are
requested, or NULL
to indicate that all keycodes and keyvals for the specified
modifier set are to be included. [element-type AtspiKeyDefinition][allow-none]
|
|
an AtspiKeyMaskType mask indicating which
key event modifiers must be set in combination with keys ,
events will only be reported for key events for which all
modifiers in modmask are set. If you wish to listen for
events with multiple modifier combinations you must call
register_keystroke_listener() once for each
combination. |
|
an AtspiKeyMaskType mask indicating which types of key events are requested (ATSPI_KEY_PRESSED, etc.). |
|
a AtspiKeyListenerSyncType parameter indicating the behavior of the notification/listener transaction. |
Returns : |
TRUE if successful, otherwise FALSE. |
gboolean atspi_deregister_keystroke_listener (AtspiDeviceListener *listener
,GArray *key_set
,AtspiKeyMaskType modmask
,AtspiKeyEventMask event_types
,GError **error
);
Removes a keystroke event listener from the registry's listener queue,
ceasing notification of events with modifiers matching modmask
.
|
a pointer to the AtspiDeviceListener for which keystroke events are requested. |
|
a pointer to the
AtspiKeyDefinition array indicating which keystroke events are
requested, or NULL
to indicate that all keycodes and keyvals for the specified
modifier set are to be included. [element-type AtspiKeyDefinition][allow-none]
|
|
the key modifier mask for which this listener is to be 'deregistered' (of type AtspiKeyMaskType). |
|
an AtspiKeyMaskType mask indicating which types of key events were requested (ATSPI_KEY_PRESSED, etc.). |
Returns : |
TRUE if successful, otherwise FALSE. |
gboolean atspi_register_device_event_listener (AtspiDeviceListener *listener
,AtspiDeviceEventMask event_types
,void *filter
,GError **error
);
Register a listener for device events, for instance button events.
|
a pointer to the AtspiDeviceListener which requests the events. |
|
an AtspiDeviceEventMask mask indicating which types of key events are requested (ATSPI_KEY_PRESSED, etc.). |
|
Unused parameter. |
Returns : |
TRUE if successful, otherwise FALSE. |
gboolean atspi_deregister_device_event_listener (AtspiDeviceListener *listener
,void *filter
,GError **error
);
Removes a device event listener from the registry's listener queue, ceasing notification of events of the specified type.
|
a pointer to the AtspiDeviceListener for which device events are requested. |
|
Unused parameter. |
Returns : |
TRUE if successful, otherwise FALSE. |
gboolean atspi_generate_keyboard_event (glong keyval
,const gchar *keystring
,AtspiKeySynthType synth_type
,GError **error
);
Synthesize a keyboard event (as if a hardware keyboard event occurred in the current UI context).
|
a long integer indicating the keycode or keysym of the key event being synthesized. |
|
an (optional) UTF-8 string which, if keyval is NULL,
indicates a 'composed' keyboard input string which is
being synthesized; this type of keyboard event synthesis does
not emulate hardware keypresses but injects the string
as though a composing input method (such as XIM) were used. |
|
a AtspiKeySynthType flag indicating whether keyval
is to be interpreted as a keysym rather than a keycode
(ATSPI_KEYSYM), or whether to synthesize
ATSPI_KEY_PRESS, ATSPI_KEY_RELEASE, or both (ATSPI_KEY_PRESSRELEASE). |
Returns : |
TRUE if successful, otherwise FALSE. |
gboolean atspi_generate_mouse_event (glong x
,glong y
,const gchar *name
,GError **error
);
Synthesize a mouse event at a specific screen coordinate. Most AT clients should use the AccessibleAction interface when tempted to generate mouse events, rather than this method. Event names: b1p = button 1 press; b2r = button 2 release; b3c = button 3 click; b2d = button 2 double-click; abs = absolute motion; rel = relative motion.
|
a long indicating the screen x coordinate of the mouse event. |
|
a long indicating the screen y coordinate of the mouse event. |
|
a string indicating which mouse event to be synthesized (e.g. "b1p", "b1c", "b2r", "rel", "abs"). |
Returns : |
TRUE if successful, otherwise FALSE. |