AccessibleText

Added in version 4.14.

class AccessibleText(*args, **kwargs)

Implementations: Inscription, Label, Text, TextView

An interface for accessible objects containing formatted text.

The GtkAccessibleText interfaces is meant to be implemented by accessible objects that have text formatted with attributes, or non-trivial text contents.

You should use the LABEL or the DESCRIPTION properties for accessible objects containing simple, unformatted text.

Methods

class AccessibleText
update_caret_position() → None

Updates the position of the caret.

Implementations of the GtkAccessibleText interface should call this function every time the caret has moved, in order to notify assistive technologies.

Added in version 4.14.

update_contents(change: AccessibleTextContentChange, start: int, end: int) → None

Notifies assistive technologies of a change in contents.

Implementations of the GtkAccessibleText interface should call this function every time their contents change as the result of an operation, like an insertion or a removal.

Note: If the change is a deletion, this function must be called before removing the contents, if it is an insertion, it must be called after inserting the new contents.

Added in version 4.14.

Parameters:

  • change – the type of change in the contents

  • start – the starting offset of the change, in characters

  • end – the end offset of the change, in characters

update_selection_bound() → None

Updates the boundary of the selection.

Implementations of the GtkAccessibleText interface should call this function every time the selection has moved, in order to notify assistive technologies.

Added in version 4.14.

Virtual Methods

class AccessibleText
do_get_attributes(offset: int) → tuple[bool, list[AccessibleTextRange], list[str], list[str]]

Retrieves the text attributes inside the accessible object.

Each attribute is composed by:

  • a range

  • a name

  • a value

It is left to the implementation to determine the serialization format of the value to a string.

GTK provides support for various text attribute names and values, but implementations of this interface are free to add their own attributes.

If this function returns true, n_ranges will be set to a value greater than or equal to one, ranges will be set to a newly allocated array of [struct#Gtk.AccessibleTextRange].

Added in version 4.14.

Parameters:

offset – the offset, in characters

do_get_caret_position() → int

Retrieves the position of the caret inside the accessible object.

Added in version 4.14.

do_get_contents(start: int, end: int) → Bytes

Retrieve the current contents of the accessible object within the given range.

If end is G_MAXUINT, the end of the range is the full content of the accessible object.

Added in version 4.14.

Parameters:

  • start – the beginning of the range, in characters

  • end – the end of the range, in characters

do_get_contents_at(offset: int, granularity: AccessibleTextGranularity) → tuple[Bytes, int, int]

Retrieve the current contents of the accessible object starting from the given offset, and using the given granularity.

The start and end values contain the boundaries of the text.

Added in version 4.14.

Parameters:

  • offset – the offset, in characters

  • granularity – the granularity of the query

do_get_default_attributes() → tuple[list[str], list[str]]

Retrieves the default text attributes inside the accessible object.

Each attribute is composed by:

  • a name

  • a value

It is left to the implementation to determine the serialization format of the value to a string.

GTK provides support for various text attribute names and values, but implementations of this interface are free to add their own attributes.

Added in version 4.14.

do_get_selection() → tuple[bool, list[AccessibleTextRange]]

Retrieves the selection ranges in the accessible object.

If this function returns true, n_ranges will be set to a value greater than or equal to one, and ranges will be set to a newly allocated array of [struct#Gtk.AccessibleTextRange].

Added in version 4.14.