|  |  |  | AT-SPI C Bindings Reference Manual |  | 
|---|---|---|---|---|
| AccessibleComponent InterfaceAccessibleComponent Interface — An interface implemented by objects which occupy area on screen. | 
enum AccessibleCoordType; enum AccessibleComponentLayer; void AccessibleComponent_ref (AccessibleComponent *obj); void AccessibleComponent_unref (AccessibleComponent *obj); SPIBoolean AccessibleComponent_contains (AccessibleComponent *obj, long int x, long int y, AccessibleCoordType ctype); Accessible* AccessibleComponent_getAccessibleAtPoint (AccessibleComponent *obj, long int x, long int y, AccessibleCoordType ctype); void AccessibleComponent_getExtents (AccessibleComponent *obj, long int *x, long int *y, long int *width, long int *height, AccessibleCoordType ctype); void AccessibleComponent_getPosition (AccessibleComponent *obj, long int *x, long int *y, AccessibleCoordType ctype); void AccessibleComponent_getSize (AccessibleComponent *obj, long int *width, long int *height); AccessibleComponentLayer AccessibleComponent_getLayer (AccessibleComponent *obj); short AccessibleComponent_getMDIZOrder (AccessibleComponent *obj); SPIBoolean AccessibleComponent_grabFocus (AccessibleComponent *obj); double AccessibleComponent_getAlpha (AccessibleComponent *obj);
The Component interface is implemented by objects which are visible, or are potentially visible, onscreen. The interface exposes onscreen bounds, the approximate "layer" in which the object resides, sometimes including z-order information, and allows objects to explicitly be told to request focus.
typedef enum {
  SPI_COORD_TYPE_SCREEN,
  SPI_COORD_TYPE_WINDOW
} AccessibleCoordType;
Specifies how xy coordinates are to be interpreted. Used by functions such
as AccessibleComponent_getPosition() and AccessibleText_getCharacterExtents()
typedef enum {
    SPI_LAYER_INVALID,
    SPI_LAYER_BACKGROUND,
    SPI_LAYER_CANVAS,
    SPI_LAYER_WIDGET,
    SPI_LAYER_MDI,
    SPI_LAYER_POPUP,
    SPI_LAYER_OVERLAY,
    SPI_LAYER_WINDOW,
    SPI_LAYER_LAST_DEFINED	
} AccessibleComponentLayer;
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.
| The layer cannot be determined or is somehow undefined. | |
| Component belongs to the destop background. | |
| Component is a canvas backdrop or drawing area. | |
| Component is a 'normal' widget. | |
| Component is drawn in the MDI layer and may have valid Z-information relative to other MDI-layer components. | |
| Component is in the popup layer, above other widgets and MDI components. | |
| Component is in the overlay plane - this value is reserved for future use. | |
| Component is in the window layer and have valid Z-information relative to other window-layer components. | |
| Used to determine the last valid value in the enum, should not be encountered. | 
void AccessibleComponent_ref (AccessibleComponent *obj);
Increment the reference count for an AccessibleComponent.
| 
 | a pointer to an object implementing AccessibleComponent on which to operate. | 
void AccessibleComponent_unref (AccessibleComponent *obj);
Decrement the reference count for an AccessibleComponent.
| 
 | a pointer to the object implementing AccessibleComponent on which to operate. | 
SPIBoolean          AccessibleComponent_contains        (AccessibleComponent *obj,
                                                         long int x,
                                                         long int y,
                                                         AccessibleCoordType ctype);
Query whether a given AccessibleComponent contains a particular point.
| 
 | a pointer to the AccessibleComponent to query. | 
| 
 | a long specifying the x coordinate in question. | 
| 
 | a long specifying the y coordinate in question. | 
| 
 | the desired coordinate system of the point ( x,y)
        (e.g. SPI_COORD_TYPE_WINDOW, SPI_COORD_TYPE_SCREEN). | 
| Returns : | a TRUE if the specified component contains the point ( x,y),
         otherwise FALSE. | 
Accessible* AccessibleComponent_getAccessibleAtPoint (AccessibleComponent *obj, long int x, long int y, AccessibleCoordType ctype);
Get the accessible child at a given coordinate within an AccessibleComponent.
| 
 | a pointer to the AccessibleComponent to query. | 
| 
 | a long specifying the x coordinate of the point in question. | 
| 
 | a long specifying the y coordinate of the point in question. | 
| 
 | the coordinate system of the point ( x,y)
        (e.g. SPI_COORD_TYPE_WINDOW, SPI_COORD_TYPE_SCREEN). | 
| Returns : | a pointer to an Accessible child of the specified component which
         contains the point ( x,y), or NULL of no child contains the point. | 
void                AccessibleComponent_getExtents      (AccessibleComponent *obj,
                                                         long int *x,
                                                         long int *y,
                                                         long int *width,
                                                         long int *height,
                                                         AccessibleCoordType ctype);
Get the bounding box of the specified AccessibleComponent.
| 
 | a pointer to the AccessibleComponent to query. | 
| 
 | a pointer to a long into which the minimum x coordinate will be returned. | 
| 
 | a pointer to a long into which the minimum y coordinate will be returned. | 
| 
 | a pointer to a long into which the x extents (width) will be returned. | 
| 
 | a pointer to a long into which the y extents (height) will be returned. | 
| 
 | the desired coordinate system into which to return the results, (e.g. SPI_COORD_TYPE_WINDOW, SPI_COORD_TYPE_SCREEN). | 
void                AccessibleComponent_getPosition     (AccessibleComponent *obj,
                                                         long int *x,
                                                         long int *y,
                                                         AccessibleCoordType ctype);
Get the minimum x and y coordinates of the specified AccessibleComponent.
| 
 | a pointer to the AccessibleComponent to query. | 
| 
 | a pointer to a long into which the minimum x coordinate will be returned. | 
| 
 | a pointer to a long into which the minimum y coordinate will be returned. | 
| 
 | the desired coordinate system into which to return the results, (e.g. SPI_COORD_TYPE_WINDOW, SPI_COORD_TYPE_SCREEN). | 
void                AccessibleComponent_getSize         (AccessibleComponent *obj,
                                                         long int *width,
                                                         long int *height);
Get the size of the specified AccessibleComponent.
| 
 | a pointer to the AccessibleComponent to query. | 
| 
 | a pointer to a long into which the x extents (width) will be returned. | 
| 
 | a pointer to a long into which the y extents (height) will be returned. | 
AccessibleComponentLayer AccessibleComponent_getLayer (AccessibleComponent *obj);
Query which layer the component is painted into, to help determine its visibility in terms of stacking order.
| 
 | a pointer to the AccessibleComponent to query. | 
| Returns : | the AccessibleComponentLayer into which this component is painted. | 
short AccessibleComponent_getMDIZOrder (AccessibleComponent *obj);
Query the z stacking order of a component which is in the MDI or window layer. (Bigger z-order numbers mean nearer the top)
| 
 | a pointer to the AccessibleComponent to query. | 
| Returns : | a short integer indicating the stacking order of the component in the MDI layer, or -1 if the component is not in the MDI layer. | 
SPIBoolean AccessibleComponent_grabFocus (AccessibleComponent *obj);
Attempt to set the keyboard input focus to the specified AccessibleComponent.