4 #include <glib/gmacros.h>
6 #include <cspi/spi-impl.h>
8 * Definitions for AccessibleRole, AccessibleState,
9 * AccessibleEvent, and event listeners.
11 #include <cspi/spi-roletypes.h>
12 #include <cspi/spi-statetypes.h>
13 #include <cspi/spi-listener.h>
16 * Auxiliary typedefs and mask definitions
18 #include <libspi/keymasks.h>
23 * Enumerated type for text boundary types
27 SPI_TEXT_BOUNDARY_CHAR,
28 SPI_TEXT_BOUNDARY_CURSOR_POS,
29 SPI_TEXT_BOUNDARY_WORD_START,
30 SPI_TEXT_BOUNDARY_WORD_END,
31 SPI_TEXT_BOUNDARY_SENTENCE_START,
32 SPI_TEXT_BOUNDARY_SENTENCE_END,
33 SPI_TEXT_BOUNDARY_LINE_START,
34 SPI_TEXT_BOUNDARY_LINE_END,
35 SPI_TEXT_BOUNDARY_ATTRIBUTE_RANGE
36 } AccessibleTextBoundaryType;
40 * Enumerated type for relation types
46 SPI_RELATION_LABEL_FOR,
47 SPI_RELATION_LABELED_BY,
48 SPI_RELATION_CONTROLLER_FOR,
49 SPI_RELATION_CONTROLLED_BY,
50 SPI_RELATION_MEMBER_OF
51 } AccessibleRelationType;
54 /* don't change the order of these ! */
56 SPI_COORD_TYPE_SCREEN,
58 } AccessibleCoordType;
65 } AccessibleKeySynthType;
68 SPI_KEYLISTENER_NOSYNC = 0,
69 SPI_KEYLISTENER_SYNCHRONOUS = 1,
70 SPI_KEYLISTENER_CANCONSUME = 2,
71 SPI_KEYLISTENER_ALL_WINDOWS = 4
72 } AccessibleKeyListenerSyncType;
74 typedef unsigned long AccessibleKeyEventMask;
77 * AccessibleComponentLayer:
78 * @SPI_LAYER_INVALID: The layer cannot be determined or is somehow undefined.
79 * @SPI_LAYER_BACKGROUND: Component belongs to the destop background.
80 * @SPI_LAYER_CANVAS: Component is a canvas backdrop or drawing area.
81 * @SPI_LAYER_WIDGET: Component is a 'normal' widget.
82 * @SPI_LAYER_MDI: Component is drawn in the MDI layer and may have valid
83 * Z-information relative to other MDI-layer components.
84 * @SPI_LAYER_POPUP: Component is in the popup layer, above other widgets and
86 * @SPI_LAYER_OVERLAY: Component is in the overlay plane - this value is reserved
88 * @SPI_LAYER_LAST_DEFINED: Used to determine the last valid value in the enum,
89 * should not be encountered.
99 SPI_LAYER_LAST_DEFINED
100 } AccessibleComponentLayer;
109 * Structure containing identifying information about a set of keycode or
112 typedef struct _AccessibleKeySet
114 unsigned long *keysyms;
115 unsigned short *keycodes;
120 * SPI_KEYSET_ALL_KEYS:
121 * @SPI_KEYSET_ALL_KEYS: A special value for an AccessibleKeySet type, which tacitly
122 * includes all keycodes and keyvals for the specified modifier set.
124 #define SPI_KEYSET_ALL_KEYS NULL
126 typedef unsigned long AccessibleKeyMaskType;
129 /* Basic SPI initialization and event loop function prototypes */
132 void SPI_event_main (void);
133 void SPI_event_quit (void);
134 SPIBoolean SPI_eventIsReady (void);
135 AccessibleEvent *SPI_nextEvent (SPIBoolean waitForEvent);
138 /* Event Listener creation and support. */
140 AccessibleEventListener *
141 createAccessibleEventListener (AccessibleEventListenerCB callback,
143 SPIBoolean AccessibleEventListener_addCallback (AccessibleEventListener *listener,
144 AccessibleEventListenerCB callback,
146 SPIBoolean AccessibleEventListener_removeCallback (AccessibleEventListener *listener,
147 AccessibleEventListenerCB callback);
148 void AccessibleEventListener_unref (AccessibleEventListener *listener);
150 /* Keystroke Listener creation and support. */
152 AccessibleKeystrokeListener *
153 createAccessibleKeystrokeListener (AccessibleKeystrokeListenerCB callback,
155 SPIBoolean AccessibleKeystrokeListener_addCallback (AccessibleKeystrokeListener *listener,
156 AccessibleKeystrokeListenerCB callback,
158 SPIBoolean AccessibleKeystrokeListener_removeCallback (AccessibleKeystrokeListener *listener,
159 AccessibleKeystrokeListenerCB callback);
160 void AccessibleKeystrokeListener_unref (AccessibleKeystrokeListener *listener);
162 /* Global functions serviced by the registry */
164 SPIBoolean registerGlobalEventListener (AccessibleEventListener *listener,
165 const char *eventType);
166 SPIBoolean deregisterGlobalEventListener (AccessibleEventListener *listener,
167 const char *eventType);
168 SPIBoolean deregisterGlobalEventListenerAll (AccessibleEventListener *listener);
170 void registerAccessibleKeystrokeListener (
171 AccessibleKeystrokeListener *listener,
172 AccessibleKeySet *keys,
173 AccessibleKeyMaskType modmask,
174 AccessibleKeyEventMask eventmask,
175 AccessibleKeyListenerSyncType sync_type);
176 void deregisterAccessibleKeystrokeListener (
177 AccessibleKeystrokeListener *listener,
178 AccessibleKeyMaskType modmask);
180 int getDesktopCount (void);
181 Accessible *getDesktop (int i);
182 int getDesktopList (Accessible **list);
184 void generateKeyEvent (long int keyval,
185 AccessibleKeySynthType synth_type);
186 void generateMouseEvent (long int x, long int y, char *name);
188 /* Accessible function prototypes */
190 int Accessible_ref (Accessible *obj);
191 int Accessible_unref (Accessible *obj);
192 char * Accessible_getName (Accessible *obj);
193 char * Accessible_getDescription (Accessible *obj);
194 Accessible * Accessible_getParent (Accessible *obj);
195 long Accessible_getChildCount (Accessible *obj);
196 Accessible * Accessible_getChildAtIndex (Accessible *obj,
197 long int childIndex);
198 long Accessible_getIndexInParent (Accessible *obj);
199 AccessibleRelation **Accessible_getRelationSet (Accessible *obj);
200 const char * Accessible_getRole (Accessible *obj);
201 AccessibleStateSet * Accessible_getStateSet (Accessible *obj);
203 /* Interface query methods */
205 SPIBoolean Accessible_isAction (Accessible *obj);
206 SPIBoolean Accessible_isApplication (Accessible *obj);
207 SPIBoolean Accessible_isComponent (Accessible *obj);
208 SPIBoolean Accessible_isEditableText (Accessible *obj);
209 SPIBoolean Accessible_isHypertext (Accessible *obj);
210 SPIBoolean Accessible_isImage (Accessible *obj);
211 SPIBoolean Accessible_isSelection (Accessible *obj);
212 SPIBoolean Accessible_isTable (Accessible *obj);
213 SPIBoolean Accessible_isText (Accessible *obj);
214 SPIBoolean Accessible_isValue (Accessible *obj);
216 AccessibleAction * Accessible_getAction (Accessible *obj);
217 AccessibleApplication * Accessible_getApplication (Accessible *obj);
218 AccessibleComponent * Accessible_getComponent (Accessible *obj);
219 AccessibleEditableText * Accessible_getEditableText (Accessible *obj);
220 AccessibleHypertext * Accessible_getHypertext (Accessible *obj);
221 AccessibleImage * Accessible_getImage (Accessible *obj);
222 AccessibleSelection * Accessible_getSelection (Accessible *obj);
223 AccessibleTable * Accessible_getTable (Accessible *obj);
224 AccessibleText * Accessible_getText (Accessible *obj);
225 AccessibleValue * Accessible_getValue (Accessible *obj);
226 GenericInterface * Accessible_queryInterface (Accessible *obj,
227 const char *interface_name);
230 * AccessibleAction function prototypes
234 AccessibleAction_ref (AccessibleAction *obj);
237 AccessibleAction_unref (AccessibleAction *obj);
240 AccessibleAction_getNActions (AccessibleAction *obj);
243 * AccessibleAction_getName:
244 * @obj: a pointer to the #AccessibleAction implementor to query.
245 * @i: a long integer indicating which action to query.
247 * Get the name of the '@i-th' action invokable on an
248 * object implementing #AccessibleAction.
250 * Returns: the 'event type' name of the action, as a UTF-8 string.
254 AccessibleAction_getName (AccessibleAction *obj, long int i);
257 * AccessibleAction_getDescription:
258 * @obj: a pointer to the #AccessibleAction to query.
259 * @i: a long integer indicating which action to query.
261 * Get the description of '@i-th' action invokable on an
262 * object implementing #AccessibleAction.
264 * Returns: a UTF-8 string describing the '@i-th' invokable action.
268 AccessibleAction_getDescription (AccessibleAction *obj,
272 AccessibleAction_doAction (AccessibleAction *obj,
276 * AccessibleAction_getKeybinding:
277 * @obj: a pointer to the #AccessibleAction implementor to query.
278 * @i: a long integer indicating which action to query.
280 * Get the keybindings for the @i-th action invokable on an
281 * object implementing #AccessibleAction, if any are defined.
283 * Returns: a UTF-8 string which can be parsed to determine the @i-th
284 * invokable action's keybindings.
288 AccessibleAction_getKeyBinding (AccessibleAction *obj,
293 * AccessibleApplication function prototypes
298 * AccessibleApplication_unref:
299 * @obj: a pointer to the #AccessibleApplication on which to operate.
301 * Decrement the reference count for an #AccessibleApplication.
303 * Returns: (no return code implemented yet).
307 AccessibleApplication_ref (AccessibleApplication *obj);
310 * AccessibleApplication_unref:
311 * @obj: a pointer to the #AccessibleApplication object on which to operate.
313 * Decrement the reference count for an #AccessibleApplication.
315 * Returns: (no return code implemented yet).
319 AccessibleApplication_unref (AccessibleApplication *obj);
322 * AccessibleApplication_getToolkitName:
323 * @obj: a pointer to the #AccessibleApplication to query.
325 * Get the name of the UI toolkit used by an #AccessibleApplication.
327 * Returns: a UTF-8 string indicating which UI toolkit is
328 * used by an application.
332 AccessibleApplication_getToolkitName (AccessibleApplication *obj);
335 * AccessibleApplication_getVersion:
336 * @obj: a pointer to the #AccessibleApplication being queried.
338 * Get the version of the at-spi bridge exported by an
339 * #AccessibleApplication instance.
341 * Returns: a UTF-8 string indicating the application's
346 AccessibleApplication_getVersion (AccessibleApplication *obj);
349 * AccessibleApplication_getID:
350 * @obj: a pointer to the #AccessibleApplication being queried.
352 * Get the unique ID assigned by the Registry to an
353 * #AccessibleApplication instance.
354 * (Not Yet Implemented by the registry).
356 * Returns: a unique #long integer associated with the application
357 * by the Registry, or 0 if the application is not registered.
360 AccessibleApplication_getID (AccessibleApplication *obj);
363 * AccessibleApplication_pause:
364 * @obj: a pointer to the #Accessible object on which to operate.
366 * Attempt to pause the application (used when client event queue is
368 * Not Yet Implemented.
370 * Returns: #TRUE if the application was paused successfully, #FALSE otherwise.
374 AccessibleApplication_pause (AccessibleApplication *obj);
377 * AccessibleApplication_resume:
378 * @obj: a pointer to the #Accessible object on which to operate.
380 * Attempt to resume the application (used after #AccessibleApplication_pause).
381 * Not Yet Implemented.
383 * Returns: #TRUE if application processing resumed successfully, #FALSE otherwise.
387 AccessibleApplication_resume (AccessibleApplication *obj);
391 * AccessibleComponent function prototypes
396 AccessibleComponent_ref (AccessibleComponent *obj);
399 AccessibleComponent_unref (AccessibleComponent *obj);
402 AccessibleComponent_contains (AccessibleComponent *obj,
405 AccessibleCoordType ctype);
408 AccessibleComponent_getAccessibleAtPoint (AccessibleComponent *obj,
411 AccessibleCoordType ctype);
414 * AccessibleComponent_getExtents:
415 * @obj: a pointer to the #AccessibleComponent to query.
416 * @x: a pointer to a #long into which the minimum x coordinate will be returned.
417 * @y: a pointer to a #long into which the minimum y coordinate will be returned.
418 * @width: a pointer to a #long into which the x extents (width) will be returned.
419 * @height: a pointer to a #long into which the y extents (height) will be returned.
420 * @ctype: the desired coordinate system into which to return the results,
421 * (e.g. COORD_TYPE_WINDOW, COORD_TYPE_SCREEN).
423 * Get the bounding box of the specified #AccessibleComponent.
427 AccessibleComponent_getExtents (AccessibleComponent *obj,
432 AccessibleCoordType ctype);
435 AccessibleComponent_getPosition (AccessibleComponent *obj,
438 AccessibleCoordType ctype);
441 AccessibleComponent_getSize (AccessibleComponent *obj,
446 * AccessibleComponent_getLayer:
447 * @obj: a pointer to the #AccessibleComponent to query.
449 * Query which layer the component is painted into, to help determine its
450 * visibility in terms of stacking order.
452 * Returns: the #AccessibleComponentLayer into which this component is painted.
454 AccessibleComponentLayer
455 AccessibleComponent_getLayer (AccessibleComponent *obj);
458 * AccessibleComponent_getMDIZOrder:
459 * @obj: a pointer to the #AccessibleComponent to query.
461 * Query the z stacking order of a component which is in the MDI layer.
463 * Returns: a short integer indicating the stacking order of the component
464 * in the MDI layer, or -1 if the component is not in the MDI layer.
467 AccessibleComponent_getMDIZOrder (AccessibleComponent *obj);
470 AccessibleComponent_grabFocus (AccessibleComponent *obj);
474 * AccessibleEditableText function prototypes
479 AccessibleEditableText_ref (AccessibleEditableText *obj);
482 AccessibleEditableText_unref (AccessibleEditableText *obj);
485 AccessibleEditableText_setAttributes (AccessibleEditableText *obj,
486 const char *attributes,
487 long int startOffset,
491 AccessibleEditableText_setTextContents (AccessibleEditableText *obj,
492 const char *newContents);
495 AccessibleEditableText_insertText (AccessibleEditableText *obj,
501 AccessibleEditableText_copyText (AccessibleText *obj,
506 AccessibleEditableText_cutText (AccessibleEditableText *obj,
511 AccessibleEditableText_deleteText (AccessibleEditableText *obj,
516 AccessibleEditableText_pasteText (AccessibleEditableText *obj,
521 * AccessibleHyperlink function prototypes
526 AccessibleHyperlink_getNAnchors (AccessibleHyperlink *obj);
529 AccessibleHyperlink_getURI (AccessibleHyperlink *obj,
533 AccessibleHyperlink_getObject (AccessibleHyperlink *obj,
537 AccessibleHyperlink_getIndexRange (AccessibleHyperlink *obj,
538 long int *startIndex,
542 AccessibleHyperlink_isValid (AccessibleHyperlink *obj);
546 * AccessibleHypertext function prototypes
551 AccessibleHypertext_ref (AccessibleHypertext *obj);
554 AccessibleHypertext_unref (AccessibleHypertext *obj);
557 AccessibleHypertext_getNLinks (AccessibleHypertext *obj);
559 AccessibleHyperlink *
560 AccessibleHypertext_getLink (AccessibleHypertext *obj,
564 AccessibleHypertext_getLinkIndex (AccessibleHypertext *obj,
565 long int characterOffset);
569 * AccessibleImage function prototypes
574 AccessibleImage_ref (AccessibleImage *obj);
577 AccessibleImage_unref (AccessibleImage *obj);
580 AccessibleImage_getImageDescription (AccessibleImage *obj);
583 AccessibleImage_getImageSize (AccessibleImage *obj,
588 AccessibleImage_getImagePosition (AccessibleImage *obj,
591 AccessibleCoordType ctype);
594 AccessibleImage_getImageExtents (AccessibleImage *obj,
599 AccessibleCoordType ctype);
602 * AccessibleRelation function prototypes
607 AccessibleRelation_ref (AccessibleRelation *obj);
610 AccessibleRelation_unref (AccessibleRelation *obj);
612 AccessibleRelationType
613 AccessibleRelation_getRelationType (AccessibleRelation *obj);
616 AccessibleRelation_getNTargets (AccessibleRelation *obj);
619 AccessibleRelation_getTarget (AccessibleRelation *obj, int i);
624 * AccessibleSelection function prototypes
629 AccessibleSelection_ref (AccessibleSelection *obj);
632 AccessibleSelection_unref (AccessibleSelection *obj);
635 AccessibleSelection_getNSelectedChildren (AccessibleSelection *obj);
638 AccessibleSelection_getSelectedChild (AccessibleSelection *obj,
639 long int selectedChildIndex);
642 AccessibleSelection_selectChild (AccessibleSelection *obj,
643 long int childIndex);
646 AccessibleSelection_deselectSelectedChild (AccessibleSelection *obj,
647 long int selectedChildIndex);
650 AccessibleSelection_isChildSelected (AccessibleSelection *obj,
651 long int childIndex);
654 AccessibleSelection_selectAll (AccessibleSelection *obj);
657 AccessibleSelection_clearSelection (AccessibleSelection *obj);
662 * AccessibleStateSet function prototypes
667 AccessibleStateSet_ref (AccessibleStateSet *obj);
670 AccessibleStateSet_unref (AccessibleStateSet *obj);
673 AccessibleStateSet_contains (AccessibleStateSet *obj,
674 AccessibleState state);
677 AccessibleStateSet_add (AccessibleStateSet *obj,
678 AccessibleState state);
681 AccessibleStateSet_remove (AccessibleStateSet *obj,
682 AccessibleState state);
685 AccessibleStateSet_equals (AccessibleStateSet *obj,
686 AccessibleStateSet *obj2);
689 AccessibleStateSet_compare (AccessibleStateSet *obj,
690 AccessibleStateSet *obj2);
693 AccessibleStateSet_isEmpty (AccessibleStateSet *obj);
698 * AccessibleTable function prototypes
703 AccessibleTable_ref (AccessibleTable *obj);
706 AccessibleTable_unref (AccessibleTable *obj);
709 AccessibleTable_getCaption (AccessibleTable *obj);
712 AccessibleTable_getSummary (AccessibleTable *obj);
715 AccessibleTable_getNRows (AccessibleTable *obj);
718 AccessibleTable_getNColumns (AccessibleTable *obj);
721 AccessibleTable_getAccessibleAt (AccessibleTable *obj,
726 AccessibleTable_getIndexAt (AccessibleTable *obj,
731 AccessibleTable_getRowAtIndex (AccessibleTable *obj,
735 AccessibleTable_getColumnAtIndex (AccessibleTable *obj,
739 AccessibleTable_getRowDescription (AccessibleTable *obj,
743 AccessibleTable_getColumnDescription (AccessibleTable *obj,
747 AccessibleTable_getRowExtentAt (AccessibleTable *obj,
752 AccessibleTable_getColumnExtentAt (AccessibleTable *obj,
757 AccessibleTable_getRowHeader (AccessibleTable *obj,
761 AccessibleTable_getColumnHeader (AccessibleTable *obj,
765 AccessibleTable_getNSelectedRows (AccessibleTable *obj);
768 AccessibleTable_getSelectedRows (AccessibleTable *obj,
769 long int **selectedRows);
772 AccessibleTable_getNSelectedColumns (AccessibleTable *obj);
775 AccessibleTable_getSelectedColumns (AccessibleTable *obj,
776 long int **selectedColumns);
779 AccessibleTable_isRowSelected (AccessibleTable *obj,
783 AccessibleTable_isColumnSelected (AccessibleTable *obj,
787 AccessibleTable_isSelected (AccessibleTable *obj,
793 * AccessibleText function prototypes
798 AccessibleText_ref (AccessibleText *obj);
801 AccessibleText_unref (AccessibleText *obj);
804 AccessibleText_getCharacterCount (AccessibleText *obj);
807 AccessibleText_getText (AccessibleText *obj,
808 long int startOffset,
812 AccessibleText_getCaretOffset (AccessibleText *obj);
815 AccessibleText_getAttributes (AccessibleText *obj,
817 long int *startOffset,
818 long int *endOffset);
822 AccessibleText_setCaretOffset (AccessibleText *obj,
826 AccessibleText_getTextBeforeOffset (AccessibleText *obj,
828 AccessibleTextBoundaryType type,
829 long int *startOffset,
830 long int *endOffset);
833 AccessibleText_getTextAtOffset (AccessibleText *obj,
835 AccessibleTextBoundaryType type,
836 long int *startOffset,
837 long int *endOffset);
840 AccessibleText_getTextAfterOffset (AccessibleText *obj,
842 AccessibleTextBoundaryType type,
843 long int *startOffset,
844 long int *endOffset);
847 AccessibleText_getCharacterAtOffset (AccessibleText *obj,
851 AccessibleText_getCharacterExtents (AccessibleText *obj,
857 AccessibleCoordType type);
860 AccessibleText_getOffsetAtPoint (AccessibleText *obj,
863 AccessibleCoordType type);
866 AccessibleText_getNSelections (AccessibleText *obj);
869 AccessibleText_getSelection (AccessibleText *obj,
870 long int selectionNum,
871 long int *startOffset,
872 long int *endOffset);
876 AccessibleText_addSelection (AccessibleText *obj,
877 long int startOffset,
881 AccessibleText_removeSelection (AccessibleText *obj,
882 long int selectionNum);
885 AccessibleText_setSelection (AccessibleText *obj,
886 long int selectionNum,
887 long int startOffset,
892 * AccessibleValue Function Prototypes:
897 AccessibleValue_ref (AccessibleValue *obj);
900 AccessibleValue_unref (AccessibleValue *obj);
903 AccessibleValue_getMinimumValue (AccessibleValue *obj);
906 AccessibleValue_getCurrentValue (AccessibleValue *obj);
909 AccessibleValue_getMaximumValue (AccessibleValue *obj);
912 AccessibleValue_setCurrentValue (AccessibleValue *obj,
916 SPI_freeString (char *s);