import "Accessibility_Text.idl";
Inheritance diagram for Accessibility::Text:
Public Types | |
typedef sequence< Range > | RangeList |
Public Methods | |
string | getText (in long startOffset, in long endOffset) |
boolean | setCaretOffset (in long offset) |
string | getTextBeforeOffset (in long offset, in TEXT_BOUNDARY_TYPE type, out long startOffset, out long endOffset) |
string | getTextAtOffset (in long offset, in TEXT_BOUNDARY_TYPE type, out long startOffset, out long endOffset) |
string | getTextAfterOffset (in long offset, in TEXT_BOUNDARY_TYPE type, out long startOffset, out long endOffset) |
unsigned long | getCharacterAtOffset (in long offset) |
string | getAttributeValue (in long offset, in string attributeName, out long startOffset, out long endOffset, out boolean defined) |
string | getAttributes (in long offset, out long startOffset, out long endOffset) |
string | getDefaultAttributes () |
void | getCharacterExtents (in long offset, out long x, out long y, out long width, out long height, in short coordType) |
long | getOffsetAtPoint (in long x, in long y, in short coordType) |
long | getNSelections () |
void | getSelection (in long selectionNum, out long startOffset, out long endOffset) |
boolean | addSelection (in long startOffset, in long endOffset) |
boolean | removeSelection (in long selectionNum) |
boolean | setSelection (in long selectionNum, in long startOffset, in long endOffset) |
void | getRangeExtents (in long startOffset, in long endOffset, out long x, out long y, out long width, out long height, in short coordType) |
RangeList | getBoundedRanges (in long x, in long y, in long width, in long height, in short coordType, in TEXT_CLIP_TYPE xClipType, in TEXT_CLIP_TYPE yClipType) |
void | unImplemented () |
void | unImplemented2 () |
void | unImplemented3 () |
void | unImplemented4 () |
Data Fields | |
readonly attribute long | characterCount |
readonly attribute long | caretOffset |
In some cases a Text object may have, as its content, an empty string. In particular this can occur in the case of Hypertext objects which do not display explicitly textual information onscreen, as Hypertext is derived from the Text interface.
"object:text-attributes-changed"
The attributes of a range of text, or the range over which attributes apply, has changed. "object:text-changed"
The text content of this object has changed. "object:text-bounds-changed"
The character bounds of a text object have changed, for instance in response to a reformatting or reflow operation. "object:text-caret-moved"
The character offset of the text caret (visible or notional) within this object has changed. Events of this type may also be generated when an onscreen text caret appears or disappears. "object:text-selection-changed"
The range or number of text selections within this text object has changed.
|
|
|
The result of calling addSelection on objects which already have one selection present, and which do not include STATE_MULTISELECTABLE, is undefined, other than the return value.
|
|
getAttributes is deprecated in favor of getAttributeRun.
|
|
Get the string value of a named attribute at a given offset, if defined.
|
|
Return the text content within a bounding box, as a list of Range structures. Depending on the TEXT_CLIP_TYPE parameters, glyphs which are clipped by the bounding box (i.e. which lie partially inside and partially outside it) may or may not be included in the ranges returned.
|
|
|
|
Obtain a the bounding box, as x, y, width, and height, of the character or glyph at a particular character offset in this object's text content. The coordinate system in which the results are reported is specified by coordType. If an onscreen glyph corresponds to multiple character offsets, for instance if the glyph is a ligature, the bounding box reported will include the entire glyph and therefore may apply to more than one character offset.
|
|
Deprecated in favor of getDefaultAttributeSet.
|
|
Obtain the number of separate, contiguous selections in the current Text object. Text objects which do not implement selection of discontiguous text regions will always return '0' or '1'. Note that "contiguous" is defined by continuity of the offsets, i.e. a text 'selection' is defined by a start/end offset pair. In the case of bidirectional text, this means that a continguous selection may appear visually discontiguous, and vice-versa.
|
|
Get the offset of the character at a given onscreen coordinate. The coordinate system used to interpret x and y is determined by parameter coordType.
|
|
Obtain the bounding box which entirely contains a given text range. Negative values may be returned for the bounding box parameters in the event that all or part of the text range is offscreen or not mapped to the screen.
|
|
The result of calling getSelection with an out-of-range selectionNum (i.e. for a selection which does not exist) is not strictly defined, but should set endOffset equal to startOffset. |
|
Obtain all or part of the onscreen textual content of a Text object. If endOffset is specified as "-1", then this method will return the entire onscreen textual contents of the Text object.
|
|
Obtain a subset of the text content of an object which entirely follows
|
|
Obtain a subset of the text content of an object which includes the specified
|
|
Obtain a subset of the text content of an object which entirely precedes
|
|
Deselect the text contained in the specified selectionNum, if such a selection exists, otherwise do nothing. Removal of a non-existant selectionNum has no effect.
|
|
Programmatically move the text caret (visible or virtual, as above) to a given position.
|
|
Modify an existing selection's start or ending offset. Calling setSelection for a selectionNum that is not already defined has no effect. The result of calling setSelection with a selectionNum greater than 0 for objects that do not include STATE_MULTISELECTABLE is undefined.
|
|
\cond unImplemented: placeholders for future expansion. |
|
|
|
|
|
|
|
The current offset of the text caret in the Text object. This caret may be virtual, e.g. non-visual and notional-only, but if an onscreen representation of the caret position is visible, it will correspond to this offset. The caret offset is given as a character offset, as opposed to a byte offset into a text buffer or a column offset. |
|
The total current number of characters in the Text object, including whitespace and non-spacing characters. |