X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=cspi%2Fspi.h;h=9d258285de3cafd013c835c9af1d8d6b14a1399e;hb=b6a9e880c09f13a391a2a23b0dd685a518fe61a1;hp=7ebe0989499d07e07c7f9d6635b1d6d345a2a74d;hpb=2dc641070bbfb5fdf3c49a9a1c44442359f4b0f0;p=platform%2Fcore%2Fuifw%2Fat-spi2-atk.git diff --git a/cspi/spi.h b/cspi/spi.h index 7ebe098..9d25828 100644 --- a/cspi/spi.h +++ b/cspi/spi.h @@ -1,27 +1,94 @@ +/* + * AT-SPI - Assistive Technology Service Provider Interface + * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap) + * + * Copyright 2001, 2002 Sun Microsystems Inc., + * Copyright 2001, 2002 Ximian, Inc. + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Library General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the + * Free Software Foundation, Inc., 59 Temple Place - Suite 330, + * Boston, MA 02111-1307, USA. + */ + #ifndef _SPI_H #define _SPI_H +#include +#include #include /* * Definitions for AccessibleRole, AccessibleState, - * AccessibleEvent, and event listeners. + * and event listeners. */ #include #include #include + /* * Auxiliary typedefs and mask definitions */ -#include +#include #ifdef __cplusplus extern "C" { #endif -/* - * Enumerated type for text boundary types - */ +/** + *AccessibleCollectionMatchType: + * + *@SPI_COLLECTION_MATCH_INVALID + *@SPI_COLLECTION_MATCH_ALL TRUE if all of the criteria are met + *@SPI_COLLECTION_MATCH_ANY TRUE if any of the criteria are met + *@SPI_COLLECTION_MATCH_NONE TRUE if none of the criteria are met + *@SPI_COLLECTION_MATCH_EMPTY Same as MATCH_ALL if the criteria is non-empty; + * for empty criteria this rule requires returned value to also have empty set. + *@SPI_COLLECTION_MATCH_LAST_DEFINED + * + **/ +typedef enum +{ + SPI_COLLECTION_MATCH_INVALID, + SPI_COLLECTION_MATCH_ALL, + SPI_COLLECTION_MATCH_ANY, + SPI_COLLECTION_MATCH_NONE, + SPI_COLLECTION_MATCH_EMPTY, + SPI_COLLECTION_MATCH_LAST_DEFINED +}AccessibleCollectionMatchType; + + +/** + *AccessibleTextBoundaryType: + *@SPI_TEXT_BOUNDARY_CHAR: Delimiter is the current character's bounds. + *@SPI_TEXT_BOUNDARY_CURSOR_POS: Delimiter is the current text caret position. + *@SPI_TEXT_BOUNDARY_WORD_START: Bounds run from the first character of a word to the first + * character of the following word (i.e. including trailing whitespace, if any) within the text object. + *@SPI_TEXT_BOUNDARY_WORD_END: Bounds run from the last character of a word to the last + * character of the following word (i.e. including leading whitespace) within the text object. + *@SPI_TEXT_BOUNDARY_SENTENCE_START: Bounds run from the first character of a sentence to the first + * character of the next sentence in the text object. + *@SPI_TEXT_BOUNDARY_SENTENCE_END: Bounds run from the last character of a sentence to the last + * character of the next sentence in the text object. + *@SPI_TEXT_BOUNDARY_LINE_START: Bounds span one line of text, with the line delimiter at the end of the + * bounds, if present, within the current text object. + *@SPI_TEXT_BOUNDARY_LINE_END: Bounds span one line of text, including a preceding line delimiter + * if present within the current text object. + *@SPI_TEXT_BOUNDARY_ATTRIBUTE_RANGE: Bounds span the run, relative to the specified offset and + * text accessor API rules, over which the attributes of the text object are invariant. + * + *Text boundary types used for specifying boundaries for regions of text. + **/ typedef enum { SPI_TEXT_BOUNDARY_CHAR, @@ -35,12 +102,54 @@ typedef enum SPI_TEXT_BOUNDARY_ATTRIBUTE_RANGE } AccessibleTextBoundaryType; -/* - * - * Enumerated type for relation types +/** + *AccessibleTextClipType + *@SPI_TEXT_CLIP_NONE: No clipping to be done + *@SPI_TEXT_CLIP_MIN: Text clipped by min coordinate is omitted + *@SPI_TEXT_CLIP_MAX: Text clipped by max coordinate is omitted + *@SPI_TEXT_CLIP_BOTH: Only text fully within mix/max bound is retained * - */ + *Describes the type of clipping required. + **/ +typedef enum +{ + SPI_TEXT_CLIP_NONE, + SPI_TEXT_CLIP_MIN, + SPI_TEXT_CLIP_MAX, + SPI_TEXT_CLIP_BOTH +} AccessibleTextClipType; +/** + *AccessibleRelationType: + *@SPI_RELATION_NULL: Not used, this is an invalid value for this enumeration. + *@SPI_RELATION_LABEL_FOR: Indicates an object is a label for one or more target objects. + *@SPI_RELATION_LABELED_BY: Indicates an object is labelled by one or more target objects. + *@SPI_RELATION_CONTROLLED_BY: Indicates an object controlled by one or more target objects. + *@SPI_RELATION_CONTROLLER_FOR: Indicates an object is an controller for one or more target objects. + *@SPI_RELATION_MEMBER_OF: Indicates an object is a member of a group of one or +more target objects. + *@SPI_RELATION_NODE_CHILD_OF: Indicates an object is a cell in a treetable which is displayed because a cell in the same column is expanded and identifies that cell. + *@SPI_RELATION_EXTENDED: This value indicates that a relation other than those pre-specified by this version of AT-SPI + * is present. + *@SPI_RELATION_FLOWS_TO: Indicates that the object has content that flows logically to another + * AtkObject in a sequential way, (for instance text-flow). + *@SPI_RELATION_FLOWS_FROM: Indicates that the object has content that flows logically from + * another AtkObject in a sequential way, (for instance text-flow). + *@SPI_RELATION_SUBWINDOW_OF: Indicates a subwindow attached to a component but otherwise has no connection in the UI heirarchy to that component. + *@SPI_RELATION_EMBEDS: Indicates that the object visually embeds + * another object's content, i.e. this object's content flows around + * another's content. + *@SPI_RELATION_EMBEDDED_BY: Inverse of %SPI_RELATION_EMBEDS, indicates that + * this object's content is visualy embedded in another object. + *@SPI_RELATION_POPUP_FOR: Indicates that an object is a popup for another object. + *@SPI_RELATION_PARENT_WINDOW_OF: Indicates that an object is a parent window of another object. + *@SPI_RELATION_DESCRIBED_BY: Indicates that another object provides descriptive information about this object; more verbose than %SPI_RELATION_LABELLED_BY. + *@SPI_RELATION_DESCRIPTION_FOR: Indicates that an object provides descriptive information about another object; more verbose than %SPI_RELATION_LABEL_FOR. + *@SPI_RELATION_LAST_DEFINED: Do not use, this is an implementation detail used + * to identify the size of this enumeration. + * + *Describes the type of the relation + **/ typedef enum { SPI_RELATION_NULL, @@ -51,16 +160,49 @@ typedef enum SPI_RELATION_MEMBER_OF, SPI_RELATION_NODE_CHILD_OF, SPI_RELATION_EXTENDED, + SPI_RELATION_FLOWS_TO, + SPI_RELATION_FLOWS_FROM, + SPI_RELATION_SUBWINDOW_OF, + SPI_RELATION_EMBEDS, + SPI_RELATION_EMBEDDED_BY, + SPI_RELATION_POPUP_FOR, + SPI_RELATION_PARENT_WINDOW_OF, + SPI_RELATION_DESCRIPTION_FOR, + SPI_RELATION_DESCRIBED_BY, SPI_RELATION_LAST_DEFINED } AccessibleRelationType; /* don't change the order of these ! */ +/** + *AccessibleCoordType: + *@SPI_COORD_TYPE_SCREEN: specifies xy coordinates relative to the screen + *@SPI_COORD_TYPE_WINDOW: specifies xy coordinates relative to an object's + * top-level window + * + *Specifies how xy coordinates are to be interpreted. Used by functions such + *as AccessibleComponent_getPosition() and AccessibleText_getCharacterExtents() + **/ typedef enum { SPI_COORD_TYPE_SCREEN, SPI_COORD_TYPE_WINDOW } AccessibleCoordType; +/** + *AccessibleKeySynthType: + *@SPI_KEY_PRESS: Generates a keypress event (requires a subsequent #SPI_KEY_RELEASE event) + *@SPI_KEY_RELEASE: Generates a key-release event + *@SPI_KEY_PRESSRELEASE: Generates a key press/release event pair. + *@SPI_KEY_SYM: Injects a "keysym" event into the stream, as if a press/release pair occurred; allows + * the user to specify the key via its symbolic name, as opposed to simulating a hardware press of a + * specific key. + *@SPI_KEY_STRING: Injects one or more keysym events into the keyboard buffer, or directly inserts + * a string value into the currently focussed text widget, if the widgets supports this. + * #SPI_KEY_STRING synthesis provides a shortcut for text substring insertion, and also allows the + * insertion of text which is not currently available via the current keyboard's keymap. + * + * Specifies the type of a generated event. + **/ typedef enum { SPI_KEY_PRESS, SPI_KEY_RELEASE, @@ -69,6 +211,31 @@ typedef enum { SPI_KEY_STRING } AccessibleKeySynthType; +/** + *AccessibleKeyListenerSyncType: + *@SPI_KEYLISTENER_NOSYNC: Events may be delivered asynchronously, + * which means in some cases they may already have been delivered to the + * application before the AT client receives the notification. + *@SPI_KEYLISTENER_SYNCHRONOUS: Events are delivered synchronously, before the + * currently focussed application sees them. + *@SPI_KEYLISTENER_CANCONSUME: Events may be consumed by the AT client. Presumes and + * requires #SPI_KEYLISTENER_SYNCHRONOUS, incompatible with #SPI_KEYLISTENER_NOSYNC. + *@SPI_KEYLISTENER_ALL_WINDOWS: Events are received not from the application toolkit layer, but + * from the device driver or windowing system subsystem; such notifications are 'global' in the + * sense that they are not broken or defeated by applications that participate poorly + * in the accessibility APIs, or not at all; however because of the intrusive nature of + * such snooping, it can have side-effects on certain older platforms. If unconditional + * event notifications, even when inaccessible or "broken" applications have focus, are not + * required, it may be best to avoid this enum value/flag. + * + *Specified the tyupe of a key listener event. + * Certain of the values above can and should be bitwise-'OR'ed + * together, observing the compatibility limitations specified in the description of + * each value. For instance, #SPI_KEYLISTENER_ALL_WINDOWS | #SPI_KEYLISTENER_CANCONSUME is + * a commonly used combination which gives the AT complete control over the delivery of matching + * events. However, such filters should be used sparingly as they may have a negative impact on + * system performance. + **/ typedef enum { SPI_KEYLISTENER_NOSYNC = 0, SPI_KEYLISTENER_SYNCHRONOUS = 1, @@ -76,22 +243,106 @@ typedef enum { SPI_KEYLISTENER_ALL_WINDOWS = 4 } AccessibleKeyListenerSyncType; + +/** + *AccessibleStreamableContentSeekType + *@SPI_STREAM_SEEK_SET: seek from the 'top' of the streamable + *@SPI_STREAM_SEEK_CUR: seek from the current position in the stream + *@SPI_STREAM_SEEK_END: seek from the end of the stream (if known) + * + *The seek type for a specified offset in AccessibleStreamableContent_seek. + **/ +typedef enum +{ + SPI_STREAM_SEEK_SET, + SPI_STREAM_SEEK_CUR, + SPI_STREAM_SEEK_END +} AccessibleStreamableContentSeekType; + +/** + * SPIException: + * @type: private + * @source: private + * @ev: private + * @code: private + * @desc: private + * + * An opaque object encapsulating information about thrown exceptions. + **/ +typedef struct _SPIException SPIException; + +/** + * SPIExceptionHandler: + * @err: points to the SPIException opaque object. + * @is_fatal: indicates whether the exception is a fatal error or not. + * + * A function type for functions to be called when exceptions occur. + * + * Returns + **/ +typedef SPIBoolean (*SPIExceptionHandler) (SPIException *err, SPIBoolean is_fatal); + +/** + * SPIExceptionCode: + * @SPI_EXCEPTION_UNSPECIFIED: An exception of unknown type, or which doesn't fit the other types. + * @SPI_EXCEPTION_DISCONNECT: Communication with the object or service has been disconnected; + * this usually means that the object or service has died or exited. + * @SPI_EXCEPTION_NO_IMPL: The object or service is missing the implementation for a request. + * @SPI_EXCEPTION_IO: The communications channel has become corrupted, blocked, or is otherwise in a bad state. + * @SPI_EXCEPTION_BAD_DATA: The data received or sent over the interface has been identified as + * improperly formatted or otherwise fails to match the expectations. + * + * Exception codes indicating what's gone wrong in an AT-SPI call. + **/ +typedef enum { + SPI_EXCEPTION_UNSPECIFIED, + SPI_EXCEPTION_DISCONNECT, + SPI_EXCEPTION_NO_IMPL, + SPI_EXCEPTION_IO, + SPI_EXCEPTION_BAD_DATA +} SPIExceptionCode; + +/** + * SPIExceptionType: + * @SPI_EXCEPTION_SOURCE_UNSPECIFIED: Don't know or can't tell where the problem is + * @SPI_EXCEPTION_SOURCE_ACCESSIBLE: The source of an event or query (i.e. an app) has thrown the exception. + * @SPI_EXCEPTION_SOURCE_REGISTRY: The AT-SPI registry has thrown the exception or cannot be reached. + * @SPI_EXCEPTION_SOURCE_DEVICE: The device event subsystem has encountered an error condition. + * + * The general source of the failure, i.e. whether the app, registry, or device system has encountered trouble. + **/ +typedef enum { + SPI_EXCEPTION_SOURCE_UNSPECIFIED, + SPI_EXCEPTION_SOURCE_ACCESSIBLE, + SPI_EXCEPTION_SOURCE_REGISTRY, + SPI_EXCEPTION_SOURCE_DEVICE +} SPIExceptionType; + typedef unsigned long AccessibleKeyEventMask; +typedef unsigned long AccessibleDeviceEventMask; /** - * AccessibleComponentLayer: - * @SPI_LAYER_INVALID: The layer cannot be determined or is somehow undefined. - * @SPI_LAYER_BACKGROUND: Component belongs to the destop background. - * @SPI_LAYER_CANVAS: Component is a canvas backdrop or drawing area. - * @SPI_LAYER_WIDGET: Component is a 'normal' widget. - * @SPI_LAYER_MDI: Component is drawn in the MDI layer and may have valid - * Z-information relative to other MDI-layer components. - * @SPI_LAYER_POPUP: Component is in the popup layer, above other widgets and - * MDI components. - * @SPI_LAYER_OVERLAY: Component is in the overlay plane - this value is reserved - * for future use. - * @SPI_LAYER_LAST_DEFINED: Used to determine the last valid value in the enum, - * should not be encountered. + *AccessibleComponentLayer: + *@SPI_LAYER_INVALID: The layer cannot be determined or is somehow undefined. + *@SPI_LAYER_BACKGROUND: Component belongs to the destop background. + *@SPI_LAYER_CANVAS: Component is a canvas backdrop or drawing area. + *@SPI_LAYER_WIDGET: Component is a 'normal' widget. + *@SPI_LAYER_MDI: Component is drawn in the MDI layer and may have valid + * Z-information relative to other MDI-layer components. + *@SPI_LAYER_POPUP: Component is in the popup layer, above other widgets and + * MDI components. + *@SPI_LAYER_OVERLAY: Component is in the overlay plane - this value is reserved + * for future use. + *@SPI_LAYER_WINDOW: Component is in the window layer and have valid Z-information + * relative to other window-layer components. + *@SPI_LAYER_LAST_DEFINED: Used to determine the last valid value in the enum, + * should not be encountered. + * + * Describes the layer of a component. + * + * These enumerated "layer values" are used when determining which UI + * rendering layer a component is drawn into, which can help in making + * determinations of when components occlude one another. **/ typedef enum { SPI_LAYER_INVALID, @@ -101,11 +352,28 @@ typedef enum { SPI_LAYER_MDI, SPI_LAYER_POPUP, SPI_LAYER_OVERLAY, + SPI_LAYER_WINDOW, SPI_LAYER_LAST_DEFINED } AccessibleComponentLayer; /** + * AccessibleTextRange: + * @start: the first nominal character position within the range. + * @end: the first nominal character position following the range. + * @content: The actual text content between @start and @end, as a UTF-8 string. + * + * Structure which encapsulates a text range - must be associated with an + * AccessibleText-implementing object. + **/ +typedef struct _AccessibleTextRange +{ + long int start; + long int end; + char *contents; +} AccessibleTextRange; + +/** * AccessibleKeySet: * @keysyms: * @keycodes: @@ -122,14 +390,34 @@ typedef struct _AccessibleKeySet short len; } AccessibleKeySet; +/* + * A special value for an AccessibleKeySet type, which tacitly + * includes all keycodes and keyvals for the specified modifier set. + */ +#define SPI_KEYSET_ALL_KEYS NULL + +typedef unsigned long AccessibleModifierMaskType; /** - * SPI_KEYSET_ALL_KEYS: - * @SPI_KEYSET_ALL_KEYS: A special value for an AccessibleKeySet type, which tacitly - * includes all keycodes and keyvals for the specified modifier set. + *AccessibleKeyMaskType: + * + *AccessibleKeyMaskType is a mask which is a set of key event modifiers + *which is specified in SPI_registerAccessibleKeystrokeListener. **/ -#define SPI_KEYSET_ALL_KEYS NULL -typedef unsigned long AccessibleKeyMaskType; +typedef AccessibleModifierMaskType AccessibleKeyMaskType; + +typedef struct _AccessibleAttributeSet +{ + int len; + char **attributes; +} AccessibleAttributeSet; + +typedef struct _AccessibleRoleSet +{ + int len; + AccessibleRole *roles; +} AccessibleRoleSet; + /* Basic SPI initialization and event loop function prototypes */ @@ -163,7 +451,9 @@ SPIBoolean AccessibleEventListener_removeCallback ( void AccessibleEventListener_unref ( AccessibleEventListener *listener); -/* Keystroke Listener creation and support. */ +/* Device Event Listener creation and support. */ + +/* First four are deprecated in favor of the last four; really just a re-name */ AccessibleKeystrokeListener * SPI_createAccessibleKeystrokeListener ( AccessibleKeystrokeListenerCB callback, @@ -178,6 +468,19 @@ SPIBoolean AccessibleKeystrokeListener_removeCallback ( void AccessibleKeystrokeListener_unref ( AccessibleKeystrokeListener *listener); +AccessibleDeviceListener * SPI_createAccessibleDeviceListener ( + AccessibleDeviceListenerCB callback, + void *user_data); +SPIBoolean AccessibleDeviceListener_addCallback ( + AccessibleDeviceListener *listener, + AccessibleDeviceListenerCB callback, + void *user_data); +SPIBoolean AccessibleDeviceListener_removeCallback ( + AccessibleDeviceListener *listener, + AccessibleDeviceListenerCB callback); +void AccessibleDeviceListener_unref ( + AccessibleDeviceListener *listener); + /* Global functions serviced by the registry */ SPIBoolean SPI_registerGlobalEventListener ( @@ -198,9 +501,18 @@ SPIBoolean SPI_deregisterAccessibleKeystrokeListener ( AccessibleKeystrokeListener *listener, AccessibleKeyMaskType modmask); +SPIBoolean SPI_registerDeviceEventListener ( + AccessibleDeviceListener *listener, + AccessibleDeviceEventMask eventmask, + void *filter); +SPIBoolean SPI_deregisterDeviceEventListener ( + AccessibleDeviceListener *listener, + void *filter); + int SPI_getDesktopCount (void); Accessible *SPI_getDesktop (int i); -int SPI_getDesktopList (Accessible **list); +int SPI_getDesktopList (Accessible ***desktop_list); +void SPI_freeDesktopList (Accessible **desktop_list); SPIBoolean SPI_generateKeyboardEvent (long int keyval, char *keystring, @@ -222,16 +534,22 @@ long Accessible_getIndexInParent (Accessible *obj); AccessibleRelation **Accessible_getRelationSet (Accessible *obj); AccessibleRole Accessible_getRole (Accessible *obj); char * Accessible_getRoleName (Accessible *obj); +char * Accessible_getLocalizedRoleName (Accessible *obj); AccessibleStateSet * Accessible_getStateSet (Accessible *obj); +AccessibleAttributeSet *Accessible_getAttributes (Accessible *obj); +AccessibleApplication *Accessible_getHostApplication (Accessible *obj); /* Interface query methods */ SPIBoolean Accessible_isAction (Accessible *obj); SPIBoolean Accessible_isApplication (Accessible *obj); +SPIBoolean Accessible_isCollection (Accessible *obj); SPIBoolean Accessible_isComponent (Accessible *obj); +SPIBoolean Accessible_isDocument (Accessible *obj); SPIBoolean Accessible_isEditableText (Accessible *obj); SPIBoolean Accessible_isHypertext (Accessible *obj); SPIBoolean Accessible_isImage (Accessible *obj); +SPIBoolean Accessible_isMatchRule (Accessible *obj); SPIBoolean Accessible_isSelection (Accessible *obj); SPIBoolean Accessible_isStreamableContent (Accessible *obj); SPIBoolean Accessible_isTable (Accessible *obj); @@ -240,10 +558,13 @@ SPIBoolean Accessible_isValue (Accessible *obj); AccessibleAction * Accessible_getAction (Accessible *obj); AccessibleApplication * Accessible_getApplication (Accessible *obj); +AccessibleCollection * Accessible_getCollection (Accessible *obj); AccessibleComponent * Accessible_getComponent (Accessible *obj); +AccessibleDocument * Accessible_getDocument (Accessible *obj); AccessibleEditableText * Accessible_getEditableText (Accessible *obj); AccessibleHypertext * Accessible_getHypertext (Accessible *obj); AccessibleImage * Accessible_getImage (Accessible *obj); +AccessibleMatchRule * Accessible_getMatchRule (Accessible *obj); AccessibleSelection * Accessible_getSelection (Accessible *obj); AccessibleStreamableContent * Accessible_getStreamableContent (Accessible *obj); AccessibleTable * Accessible_getTable (Accessible *obj); @@ -273,9 +594,27 @@ void AccessibleApplication_unref (AccessibleApplication *obj); char *AccessibleApplication_getToolkitName (AccessibleApplication *obj); char *AccessibleApplication_getVersion (AccessibleApplication *obj); long AccessibleApplication_getID (AccessibleApplication *obj); +char *AccessibleApplication_getLocale (AccessibleApplication *obj, int lc_category); SPIBoolean AccessibleApplication_pause (AccessibleApplication *obj); SPIBoolean AccessibleApplication_resume (AccessibleApplication *obj); +/* AccessibleCollection function prototypes */ +void AccessibleCollection_ref (AccessibleCollection *obj); +void AccessibleCollection_unref (AccessibleCollection *obj); +AccessibleMatchRule * +AccessibleCollection_createMatchRule (AccessibleCollection *obj, + AccessibleStateSet *states, + AccessibleCollectionMatchType statematchtype, + AccessibleAttributeSet *attributes, + AccessibleCollectionMatchType attributematchtype, + AccessibleRoleSet *roles, + AccessibleCollectionMatchType rolematchtype, + char *interfaces, + AccessibleCollectionMatchType interfacematchtype, + long int invert); +void +AccessibleCollection_freeMatchRule (AccessibleCollection *obj, + AccessibleMatchRule *matchrule); /* AccessibleComponent function prototypes */ void AccessibleComponent_ref (AccessibleComponent *obj); @@ -304,8 +643,18 @@ void AccessibleComponent_getSize (AccessibleComponent *obj, long int *height); AccessibleComponentLayer AccessibleComponent_getLayer (AccessibleComponent *obj); -void AccessibleComponent_grabFocus (AccessibleComponent *obj); +SPIBoolean AccessibleComponent_grabFocus (AccessibleComponent *obj); short AccessibleComponent_getMDIZOrder(AccessibleComponent *obj); +double AccessibleComponent_getAlpha (AccessibleComponent *obj); + +/* AccessibleDocument function prototypes */ + +void AccessibleDocument_ref (AccessibleDocument *obj); +void AccessibleDocument_unref (AccessibleDocument *obj); +char *AccessibleDocument_getLocale (AccessibleDocument *obj); +char *AccessibleDocument_getAttributeValue (AccessibleDocument *obj, + char *attribute); +AccessibleAttributeSet *AccessibleDocument_getAttributes (AccessibleDocument *obj); /* AccessibleEditableText function prototypes */ @@ -435,6 +784,17 @@ AccessibleImage_getImageExtents (AccessibleImage *obj, long int *width, long int *height, AccessibleCoordType ctype); +char * +AccessibleImage_getImageLocale (AccessibleImage *obj); + +/* + * + * AccessibleMatchRule function prototypes + * + */ +void AccessibleMatchRule_ref (AccessibleMatchRule *obj); +void AccessibleMatchRule_unref (AccessibleMatchRule *obj); + /* * * AccessibleRelation function prototypes @@ -479,13 +839,17 @@ AccessibleSelection_deselectSelectedChild (AccessibleSelection *obj, long int selectedChildIndex); SPIBoolean +AccessibleSelection_deselectChild (AccessibleSelection *obj, + long int childIndex); + +SPIBoolean AccessibleSelection_isChildSelected (AccessibleSelection *obj, long int childIndex); SPIBoolean AccessibleSelection_selectAll (AccessibleSelection *obj); -void +SPIBoolean AccessibleSelection_clearSelection (AccessibleSelection *obj); @@ -527,12 +891,22 @@ void AccessibleStreamableContent_unref (AccessibleStreamableContent *obj); char ** AccessibleStreamableContent_getContentTypes (AccessibleStreamableContent *obj); + +void +AccessibleStreamableContent_freeContentTypesList (AccessibleStreamableContent *obj, + char **content_types); +#define AccessibleStreamableContent_freeContentTypeList(a, b) AccessibleStreamableContent_freeContentTypesList(a,b) + SPIBoolean AccessibleStreamableContent_open (AccessibleStreamableContent *obj, const char *content_type); SPIBoolean +AccessibleStreamableContent_close (AccessibleStreamableContent *obj); + +long AccessibleStreamableContent_seek (AccessibleStreamableContent *obj, - long int offset); + long int offset, + AccessibleStreamableContentSeekType seek_type); SPIBoolean AccessibleStreamableContent_read (AccessibleStreamableContent *obj, void *buff, @@ -595,6 +969,12 @@ AccessibleTable_getColumnExtentAt (AccessibleTable *obj, long int row, long int column); +SPIBoolean +AccessibleTable_getRowColumnExtentsAtIndex (AccessibleTable *obj, + long int index, long int *row, long int *col, + long int *row_extents, long int *col_extents, + long int *is_selected); + Accessible * AccessibleTable_getRowHeader (AccessibleTable *obj, long int row); @@ -630,6 +1010,20 @@ AccessibleTable_isSelected (AccessibleTable *obj, long int row, long int column); +SPIBoolean +AccessibleTable_addRowSelection (AccessibleTable *obj, + long int row); +SPIBoolean +AccessibleTable_addColumnSelection (AccessibleTable *obj, + long int column); + +SPIBoolean +AccessibleTable_removeRowSelection (AccessibleTable *obj, + long int row); +SPIBoolean +AccessibleTable_removeColumnSelection (AccessibleTable *obj, + long int column); + /* * * AccessibleText function prototypes @@ -656,6 +1050,8 @@ AccessibleText_getAttributes (AccessibleText *obj, long int *startOffset, long int *endOffset); +char * +AccessibleText_getDefaultAttributes (AccessibleText *obj); SPIBoolean AccessibleText_setCaretOffset (AccessibleText *obj, @@ -695,6 +1091,29 @@ AccessibleText_getCharacterExtents (AccessibleText *obj, long int *height, AccessibleCoordType type); +void +AccessibleText_getRangeExtents (AccessibleText *obj, + long int startOffset, + long int endOffset, + long int *x, + long int *y, + long int *width, + long int *height, + AccessibleCoordType type); + +AccessibleTextRange ** +AccessibleText_getBoundedRanges (AccessibleText *obj, + long int x, + long int y, + long int width, + long int height, + AccessibleCoordType type, + AccessibleTextClipType clipTypeX, + AccessibleTextClipType clipTypeY); + +void +AccessibleTextRange_freeRanges (AccessibleTextRange **ranges); + long AccessibleText_getOffsetAtPoint (AccessibleText *obj, long int x, @@ -725,6 +1144,14 @@ AccessibleText_setSelection (AccessibleText *obj, long int selectionNum, long int startOffset, long int endOffset); +AccessibleAttributeSet * +AccessibleText_getAttributeRun (AccessibleText *obj, + long int offset, + long int *startOffset, + long int *endOffset, + long int includeDefaults); +AccessibleAttributeSet * +AccessibleText_getDefaultAttributeSet (AccessibleText *obj); /* AccessibleValue Function Prototypes: */ @@ -735,10 +1162,69 @@ double AccessibleValue_getCurrentValue (AccessibleValue *obj); double AccessibleValue_getMaximumValue (AccessibleValue *obj); SPIBoolean AccessibleValue_setCurrentValue (AccessibleValue *obj, double newValue); +double AccessibleValue_getMinimumIncrement (AccessibleValue *obj); + +/* Persistance and lifecycle control for AccessibleEvents. */ +SPIBoolean AccessibleEvent_ref (const AccessibleEvent *e); +void AccessibleEvent_unref (const AccessibleEvent *e); + +/* + * Prototypes for accessor functions, to obtain context + * information for accessible events. + */ + +char* AccessibleEvent_getSourceName (const AccessibleEvent *e); +AccessibleRole AccessibleEvent_getSourceRole (const AccessibleEvent *e); +AccessibleApplication* AccessibleEvent_getSourceApplication (const AccessibleEvent *e); +SPIBoolean AccessibleEvent_getSourceDetails (const AccessibleEvent *e, char **name, + AccessibleRole *role, + AccessibleApplication **app); + +char* AccessibleTextChangedEvent_getChangeString (const AccessibleEvent *e); +Accessible * AccessibleChildChangedEvent_getChildAccessible (const AccessibleEvent *e); + +Accessible * AccessibleParentChangedEvent_getParentAccessible (const AccessibleEvent *e); -/* Misc methods */ +char* AccessibleTextSelectionChangedEvent_getSelectionString (const AccessibleEvent *e); + +char* AccessibleWindowEvent_getTitleString (const AccessibleEvent *e); + +Accessible * AccessibleActiveDescendantChangedEvent_getActiveDescendant (const AccessibleEvent *e); + +Accessible * AccessibleTableSummaryChangedEvent_getSummaryAccessible (const AccessibleEvent *e); + +Accessible * AccessibleTableHeaderChangedEvent_getHeaderAccessible (const AccessibleEvent *e); + +char * AccessibleTableCaptionChangedEvent_getCaptionString (const AccessibleEvent *e); + +char * AccessibleTableRowDescriptionChangedEvent_getDescriptionString (const AccessibleEvent *e); + +char * AccessibleTableColumnDescriptionChangedEvent_getDescriptionString (const AccessibleEvent *e); + +char * AccessibleDescriptionChangedEvent_getDescriptionString (const AccessibleEvent *e); + +char * AccessibleNameChangedEvent_getNameString (const AccessibleEvent *e); +SPIRect * AccessibleBoundsChangedEvent_getNewBounds (const AccessibleEvent *e); + +/* Misc methods and error handling */ void SPI_freeString (char *s); +char* SPI_dupString (char *s); + +void SPI_freeRect (SPIRect *r); + +SPIBoolean SPI_exceptionHandlerPush (SPIExceptionHandler *handler); + +SPIExceptionHandler* SPI_exceptionHandlerPop (void); + +SPIExceptionType SPIException_getSourceType (SPIException *err); + +SPIExceptionCode SPIException_getExceptionCode (SPIException *err); + +Accessible* SPIAccessibleException_getSource (SPIException *err); + +char* SPIException_getDescription (SPIException *err); + #ifdef __cplusplus } #endif