Top | ![]() |
![]() |
![]() |
![]() |
int | SPI_init () |
void | SPI_event_main () |
void | SPI_event_quit () |
SPIBoolean | SPI_eventIsReady () |
AccessibleEvent * | SPI_nextEvent () |
int | SPI_exit () |
void | SPI_freeString () |
Accessible * | SPIAccessibleException_getSource () |
char * | SPIException_getDescription () |
SPIExceptionCode | SPIException_getExceptionCode () |
SPIExceptionType | SPIException_getSourceType () |
SPIBoolean | (*SPIExceptionHandler) () |
void | SPI_freeRect () |
char * | SPI_dupString () |
SPIBoolean | SPI_exceptionHandlerPush () |
SPIExceptionHandler * | SPI_exceptionHandlerPop () |
void
SPI_event_main (void
);
Starts/enters the main event loop for the SPI services.
(NOTE: This method does not return control, it is exited via a call to
SPI_event_quit()
from within an event handler).
void
SPI_event_quit (void
);
Quits the last main event loop for the SPI services, see SPI_event_main
SPIBoolean
SPI_eventIsReady (void
);
Checks to see if an SPI event is waiting in the event queue.
Used by clients that don't wish to use SPI_event_main()
.
Not Yet Implemented.
AccessibleEvent *
SPI_nextEvent (SPIBoolean waitForEvent
);
Gets the next event in the SPI event queue; blocks if no event
is pending and waitForEvent
is TRUE.
Used by clients that don't wish to use SPI_event_main()
.
Not Yet Implemented.
int
SPI_exit (void
);
Disconnects from the Accessibility Registry and releases any floating resources. Call only once at exit.
void
SPI_freeString (char *s
);
Free a character string returned from an at-spi call. Clients of
at-spi should use this function instead of free()
or g_free()
.
A NULL string s
will be silently ignored.
This API should not be used to free strings
from other libraries or allocated by the client.
Accessible *
SPIAccessibleException_getSource (SPIException *err
);
Get the identity of the object which threw an exception.
Since
: AT-SPI 1.4
char *
SPIException_getDescription (SPIException *err
);
Get a text description of the exception that has been thrown. Unfortunately these descriptions tend to be terse and limited in the detail which they can provide.
SPIExceptionCode
SPIException_getExceptionCode (SPIException *err
);
Get the SPIExceptionCode telling what type of exception condition has occurred.
Since
: AT-SPI 1.4
SPIExceptionType
SPIException_getSourceType (SPIException *err
);
Get the SPIExceptionType of an exception which has been thrown.
Since
: AT-SPI 1.4
SPIBoolean (*SPIExceptionHandler) (SPIException *err
,SPIBoolean is_fatal
);
A function type for functions to be called when exceptions occur.
Returns
void
SPI_freeRect (SPIRect *r
);
Free a SPIRect structure returned from an at-spi call. Clients of
at-spi should use this function instead of free()
or g_free()
.
A NULL rect r
will be silently ignored.
This API should not be used to free data
from other libraries or allocated by the client.
Since
: AT-SPI 1.6
SPIBoolean
SPI_exceptionHandlerPush (SPIExceptionHandler *handler
);
Install a client-side handler for SPIException instances, which can see and handle any exceptions before chaining them to the next exception handler in the stack.
Since
: AT-SPI 1.4
Returns TRUE
if the result succeeded, FALSE
if hander
could not be registered.
SPIExceptionHandler *
SPI_exceptionHandlerPop (void
);
Remove/pop an SPIExceptionHandler off the error handler stack and return the new handler.
Since
: AT-SPI 1.4
Returns the SPIExceptionHandler which is now at the top of the error handler stack after the call.
typedef struct { SPIExceptionType type; CORBA_Object source; CORBA_Environment *ev; SPIExceptionCode code; char * desc; } SPIException;
An opaque object encapsulating information about thrown exceptions.
Exception codes indicating what's gone wrong in an AT-SPI call.
An exception of unknown type, or which doesn't fit the other types. |
||
Communication with the object or service has been disconnected; this usually means that the object or service has died or exited. |
||
The object or service is missing the implementation for a request. |
||
The communications channel has become corrupted, blocked, or is otherwise in a bad state. |
||
The data received or sent over the interface has been identified as improperly formatted or otherwise fails to match the expectations. |
The general source of the failure, i.e. whether the app, registry, or device system has encountered trouble.