AtkText
The ATK interface implemented by components with text content.
#AtkText should be implemented by #AtkObjects on behalf of widgets that
have text content which is either attributed or otherwise non-trivial.
#AtkObjects whose text content is simple, unattributed, and very brief
may expose that content via #atk_object_get_name instead; however if the
text is editable, multi-line, typically longer than three or four words,
attributed, selectable, or if the object already uses the 'name' ATK
property for other information, the #AtkText interface should be used
to expose the text content. In the case of editable text content,
#AtkEditableText (a subtype of the #AtkText interface) should be
implemented instead.
#AtkText provides not only traversal facilities and change notification
for text content, but also caret tracking and glyph bounding box
calculations. Note that the text strings are exposed as UTF-8, and are
therefore potentially multi-byte, and caret-to-byte offset mapping makes
no assumptions about the character length; also bounding box
glyph-to-offset mapping may be complex for languages which use ligatures.
The AtkText structure does not contain any fields.
@ATK_TEXT_BOUNDARY_CHAR:
@ATK_TEXT_BOUNDARY_WORD_START:
@ATK_TEXT_BOUNDARY_WORD_END:
@ATK_TEXT_BOUNDARY_SENTENCE_START:
@ATK_TEXT_BOUNDARY_SENTENCE_END:
@ATK_TEXT_BOUNDARY_LINE_START:
@ATK_TEXT_BOUNDARY_LINE_END:
@name:
@value:
@ATK_TEXT_ATTR_INVALID:
@ATK_TEXT_ATTR_LEFT_MARGIN:
@ATK_TEXT_ATTR_RIGHT_MARGIN:
@ATK_TEXT_ATTR_INDENT:
@ATK_TEXT_ATTR_INVISIBLE:
@ATK_TEXT_ATTR_EDITABLE:
@ATK_TEXT_ATTR_PIXELS_ABOVE_LINES:
@ATK_TEXT_ATTR_PIXELS_BELOW_LINES:
@ATK_TEXT_ATTR_PIXELS_INSIDE_WRAP:
@ATK_TEXT_ATTR_BG_FULL_HEIGHT:
@ATK_TEXT_ATTR_RISE:
@ATK_TEXT_ATTR_UNDERLINE:
@ATK_TEXT_ATTR_STRIKETHROUGH:
@ATK_TEXT_ATTR_SIZE:
@ATK_TEXT_ATTR_SCALE:
@ATK_TEXT_ATTR_WEIGHT:
@ATK_TEXT_ATTR_LANGUAGE:
@ATK_TEXT_ATTR_FAMILY_NAME:
@ATK_TEXT_ATTR_BG_COLOR:
@ATK_TEXT_ATTR_FG_COLOR:
@ATK_TEXT_ATTR_BG_STIPPLE:
@ATK_TEXT_ATTR_FG_STIPPLE:
@ATK_TEXT_ATTR_WRAP_MODE:
@ATK_TEXT_ATTR_DIRECTION:
@ATK_TEXT_ATTR_JUSTIFICATION:
@ATK_TEXT_ATTR_STRETCH:
@ATK_TEXT_ATTR_VARIANT:
@ATK_TEXT_ATTR_STYLE:
@ATK_TEXT_ATTR_LAST_DEFINED:
@text:
@start_offset:
@end_offset:
@Returns:
@text:
@offset:
@Returns:
@text:
@offset:
@boundary_type:
@start_offset:
@end_offset:
@Returns:
@text:
@offset:
@boundary_type:
@start_offset:
@end_offset:
@Returns:
@text:
@offset:
@boundary_type:
@start_offset:
@end_offset:
@Returns:
@text:
@Returns:
@text:
@offset:
@x:
@y:
@width:
@height:
@coords:
@length:
@text:
@offset:
@start_offset:
@end_offset:
@Returns:
@text:
@Returns:
@text:
@Returns:
@text:
@x:
@y:
@coords:
@Returns:
@text:
@Returns:
@text:
@selection_num:
@start_offset:
@end_offset:
@Returns:
@text:
@start_offset:
@end_offset:
@Returns:
@text:
@selection_num:
@Returns:
@text:
@selection_num:
@start_offset:
@end_offset:
@Returns:
@text:
@offset:
@Returns:
@attrib_set:
@name:
@Returns:
@attr:
@Returns:
@name:
@Returns:
@attr:
@index:
@Returns:
@atktext: the object which received the signal.
@arg1: The new position of the text caret.
This signal will have a detail which is either "insert" or "delete"
which identifies whether the text change was an insertion or a deletion
@atktext: the object which received the signal.
@arg1: The position of the insertion or deletion.
@arg2: The length of text inserted or deleted.
@atktext: the object which received the signal.