AccessibleText Interface

Name

AccessibleText Interface -- 

Synopsis



enum        AccessibleTextBoundaryType;
void        AccessibleText_ref              (AccessibleText *obj);
void        AccessibleText_unref            (AccessibleText *obj);
SPIBoolean  AccessibleText_addSelection     (AccessibleText *obj,
                                             long int startOffset,
                                             long int endOffset);
char*       AccessibleText_getAttributes    (AccessibleText *obj,
                                             long int offset,
                                             long int *startOffset,
                                             long int *endOffset);
long        AccessibleText_getCaretOffset   (AccessibleText *obj);
long        AccessibleText_getCharacterCount
                                            (AccessibleText *obj);
void        AccessibleText_getCharacterExtents
                                            (AccessibleText *obj,
                                             long int offset,
                                             long int *x,
                                             long int *y,
                                             long int *width,
                                             long int *height,
                                             AccessibleCoordType type);
long        AccessibleText_getNSelections   (AccessibleText *obj);
long        AccessibleText_getOffsetAtPoint (AccessibleText *obj,
                                             long int x,
                                             long int y,
                                             AccessibleCoordType type);
void        AccessibleText_getSelection     (AccessibleText *obj,
                                             long int selectionNum,
                                             long int *startOffset,
                                             long int *endOffset);
char*       AccessibleText_getText          (AccessibleText *obj,
                                             long int startOffset,
                                             long int endOffset);
char*       AccessibleText_getTextBeforeOffset
                                            (AccessibleText *obj,
                                             long int offset,
                                             AccessibleTextBoundaryType type,
                                             long int *startOffset,
                                             long int *endOffset);
char*       AccessibleText_getTextAfterOffset
                                            (AccessibleText *obj,
                                             long int offset,
                                             AccessibleTextBoundaryType type,
                                             long int *startOffset,
                                             long int *endOffset);
char*       AccessibleText_getTextAtOffset  (AccessibleText *obj,
                                             long int offset,
                                             AccessibleTextBoundaryType type,
                                             long int *startOffset,
                                             long int *endOffset);
SPIBoolean  AccessibleText_removeSelection  (AccessibleText *obj,
                                             long int selectionNum);
SPIBoolean  AccessibleText_setCaretOffset   (AccessibleText *obj,
                                             long int newOffset);
SPIBoolean  AccessibleText_setSelection     (AccessibleText *obj,
                                             long int selectionNum,
                                             long int startOffset,
                                             long int endOffset);

Description

Details

enum AccessibleTextBoundaryType

typedef enum
{
  SPI_TEXT_BOUNDARY_CHAR,
  SPI_TEXT_BOUNDARY_CURSOR_POS,
  SPI_TEXT_BOUNDARY_WORD_START,
  SPI_TEXT_BOUNDARY_WORD_END,
  SPI_TEXT_BOUNDARY_SENTENCE_START,
  SPI_TEXT_BOUNDARY_SENTENCE_END,
  SPI_TEXT_BOUNDARY_LINE_START,
  SPI_TEXT_BOUNDARY_LINE_END,
  SPI_TEXT_BOUNDARY_ATTRIBUTE_RANGE
} AccessibleTextBoundaryType;


AccessibleText_ref ()

void        AccessibleText_ref              (AccessibleText *obj);

Increment the reference count for an AccessibleText object.

obj : a pointer to the AccessibleText object on which to operate.


AccessibleText_unref ()

void        AccessibleText_unref            (AccessibleText *obj);

Decrement the reference count for an AccessibleText object.

obj : a pointer to the Accessible object on which to operate.


AccessibleText_addSelection ()

SPIBoolean  AccessibleText_addSelection     (AccessibleText *obj,
                                             long int startOffset,
                                             long int endOffset);

Select some text (add a text selection) in an AccessibleText object.

obj : a pointer to the AccessibleText object on which to operate.
Returns : TRUE if successful, FALSE otherwise.


AccessibleText_getAttributes ()

char*       AccessibleText_getAttributes    (AccessibleText *obj,
                                             long int offset,
                                             long int *startOffset,
                                             long int *endOffset);

Get the attributes applied to a range of text from an AccessibleText object, and the bounds of the range.

obj : a pointer to the AccessibleText object to query.
Returns : a text string describing the attributes occurring within the attribute run containing offset, encoded as UTF-8 and delimited by ':'


AccessibleText_getCaretOffset ()

long        AccessibleText_getCaretOffset   (AccessibleText *obj);

Get the current offset of the text caret in an AccessibleText object.

obj : a pointer to the AccessibleText object to query.
Returns : a long integer indicating the current position of the text caret.


AccessibleText_getCharacterCount ()

long        AccessibleText_getCharacterCount
                                            (AccessibleText *obj);

Get the character count of an AccessibleText object.

obj : a pointer to the AccessibleText object to query.
Returns : a long integer indicating the total number of characters in the AccessibleText object.


AccessibleText_getCharacterExtents ()

void        AccessibleText_getCharacterExtents
                                            (AccessibleText *obj,
                                             long int offset,
                                             long int *x,
                                             long int *y,
                                             long int *width,
                                             long int *height,
                                             AccessibleCoordType type);

Get the bounding box containing the glyph representing the character at a particular text offset.

obj : a pointer to the AccessibleText object on which to operate.


AccessibleText_getNSelections ()

long        AccessibleText_getNSelections   (AccessibleText *obj);

Get the number of active non-contiguous selections for an AccessibleText object.

obj : a pointer to the AccessibleText object on which to operate.
Returns : a long integer indicating the current number of non-contiguous text selections active within an AccessibleText object.


AccessibleText_getOffsetAtPoint ()

long        AccessibleText_getOffsetAtPoint (AccessibleText *obj,
                                             long int x,
                                             long int y,
                                             AccessibleCoordType type);

Get the bounding box for a glyph at a certain AccessibleText offset.

obj : a pointer to the AccessibleText object on which to operate.
Returns : the offset (as a long integer) at the point (x, y) in the specified coordinate system.


AccessibleText_getSelection ()

void        AccessibleText_getSelection     (AccessibleText *obj,
                                             long int selectionNum,
                                             long int *startOffset,
                                             long int *endOffset);

Get the bounds of the selectionNum-th active text selection for an AccessibleText object.

obj : a pointer to the AccessibleText object on which to operate.


AccessibleText_getText ()

char*       AccessibleText_getText          (AccessibleText *obj,
                                             long int startOffset,
                                             long int endOffset);

Get a range of text from an AccessibleText object. The number of bytes in the returned string may exceed endOffset-startOffset, since UTF-8 is a variable-width encoding.

obj : a pointer to the AccessibleText object to query.
Returns : a text string containing characters from startOffset to endOffset-1, inclusive, encoded as UTF-8.


AccessibleText_getTextBeforeOffset ()

char*       AccessibleText_getTextBeforeOffset
                                            (AccessibleText *obj,
                                             long int offset,
                                             AccessibleTextBoundaryType type,
                                             long int *startOffset,
                                             long int *endOffset);

Get delimited text from an AccessibleText object which precedes a given text offset.

obj : a pointer to the AccessibleText object on which to operate.
Returns : a UTF-8 string representing the delimited text, both of whose delimiting boundaries are before the current offset, or an empty string if no such text exists.


AccessibleText_getTextAfterOffset ()

char*       AccessibleText_getTextAfterOffset
                                            (AccessibleText *obj,
                                             long int offset,
                                             AccessibleTextBoundaryType type,
                                             long int *startOffset,
                                             long int *endOffset);

Get delimited text from an AccessibleText object which follows a given text offset.

obj : a pointer to the AccessibleText object on which to operate.
Returns : a UTF-8 string representing the delimited text, both of whose delimiting boundaries are after or inclusive of the current offset, or an empty string if no such text exists.


AccessibleText_getTextAtOffset ()

char*       AccessibleText_getTextAtOffset  (AccessibleText *obj,
                                             long int offset,
                                             AccessibleTextBoundaryType type,
                                             long int *startOffset,
                                             long int *endOffset);

Get delimited text from an AccessibleText object which includes a given text offset.

obj : a pointer to the AccessibleText object on which to operate.
Returns : a UTF-8 string representing the delimited text, whose delimiting boundaries bracket the current offset, or an empty string if no such text exists.


AccessibleText_removeSelection ()

SPIBoolean  AccessibleText_removeSelection  (AccessibleText *obj,
                                             long int selectionNum);

De-select a text selection.

obj : a pointer to the AccessibleText object on which to operate.
Returns : TRUE if successful, FALSE otherwise.


AccessibleText_setCaretOffset ()

SPIBoolean  AccessibleText_setCaretOffset   (AccessibleText *obj,
                                             long int newOffset);

Set the text caret position for an AccessibleText object.

obj : a pointer to the AccessibleText object on which to operate.
Returns : TRUE if successful, FALSE otherwise.


AccessibleText_setSelection ()

SPIBoolean  AccessibleText_setSelection     (AccessibleText *obj,
                                             long int selectionNum,
                                             long int startOffset,
                                             long int endOffset);

Change the bounds of an existing AccessibleText text selection.

obj : a pointer to the AccessibleText object on which to operate.
Returns : TRUE if successful, FALSE otherwise.