Class
AtspiAccessible
Description [src]
class Atspi.Accessible : Atspi.Object {
parent: AtspiObject,
accessible_parent: AtspiAccessible*,
children: GPtrArray*,
role: AtspiRole,
interfaces: gint,
name: char*,
description: char*,
states: AtspiStateSet*,
attributes: GHashTable*,
cached_properties: guint,
priv: AtspiAccessiblePrivate*
}The base interface which is implemented by all accessible objects.
All objects support interfaces for querying their contained ‘children’ and position in the accessible-object hierarchy, whether or not they actually have children.
Ancestors
- AtspiObject
- GObject
Instance methods
atspi_accessible_clear_cache
Clears the cached information for the given accessible and all of its descendants.
atspi_accessible_clear_cache_single
Clears the cached information only for the given accessible.
atspi_accessible_get_accessible_id
Gets the accessible id of the accessible. This is not meant to be presented to the user, but to be an id which is stable over application development. Typically, this is the gtkbuilder id.
Available since: 2.34
atspi_accessible_get_action
Gets the AtspiAction interface for an AtspiAccessible.
Deprecated since: 2.10
atspi_accessible_get_action_iface
Gets the AtspiAction interface for an AtspiAccessible.
atspi_accessible_get_application
Gets the containing AtspiApplication for an object.
atspi_accessible_get_atspi_version
Gets the AT-SPI IPC specification version supported by the application
pointed to by the AtspiAccessible object.
Only works on application root objects.
atspi_accessible_get_attributes
Gets the AttributeSet representing any assigned
name-value pair attributes or annotations for this object.
For typographic, textual, or textually-semantic attributes, see
atspi_text_get_attributes instead.
atspi_accessible_get_attributes_as_array
Gets a GArray representing any assigned
name-value pair attributes or annotations for this object.
For typographic, textual, or textually-semantic attributes, see
atspi_text_get_attributes_as_array instead.
atspi_accessible_get_child_at_index
Gets the AtspiAccessible child of an AtspiAccessible object at a given index.
atspi_accessible_get_child_count
Gets the number of children contained by an AtspiAccessible object.
atspi_accessible_get_collection
Gets the AtspiCollection interface for an AtspiAccessible.
Deprecated since: 2.10
atspi_accessible_get_collection_iface
Gets the AtspiCollection interface for an AtspiAccessible.
atspi_accessible_get_component
Gets the AtspiComponent interface for an AtspiAccessible.
Deprecated since: 2.10
atspi_accessible_get_component_iface
Gets the AtspiComponent interface for an AtspiAccessible.
atspi_accessible_get_description
Gets the description of an AtspiAccessible object.
atspi_accessible_get_document
Gets the AtspiDocument interface for an AtspiAccessible.
Deprecated since: 2.10
atspi_accessible_get_document_iface
Gets the AtspiDocument interface for an AtspiAccessible.
atspi_accessible_get_editable_text
Gets the AtspiEditableText interface for an AtspiAccessible.
Deprecated since: 2.10
atspi_accessible_get_editable_text_iface
Gets the AtspiEditableText interface for an AtspiAccessible.
atspi_accessible_get_hyperlink
Gets the AtspiHyperlink interface for an AtspiAccessible.
atspi_accessible_get_hypertext
Gets the AtspiHypertext interface for an AtspiAccessible.
Deprecated since: 2.10
atspi_accessible_get_hypertext_iface
Gets the AtspiHypertext interface for an AtspiAccessible.
atspi_accessible_get_id
Gets the application id for a AtspiAccessible object.
Only works on application root objects.
atspi_accessible_get_image
Gets the AtspiImage interface for an AtspiAccessible.
Deprecated since: 2.10
atspi_accessible_get_image_iface
Gets the AtspiImage interface for an AtspiAccessible.
atspi_accessible_get_index_in_parent
Gets the index of an AtspiAccessible object within its parent’s
AtspiAccessible children list.
atspi_accessible_get_interfaces
A set of pointers to all interfaces supported by an AtspiAccessible.
atspi_accessible_get_localized_role_name
Gets a UTF-8 string corresponding to the name of the role played by an object, translated to the current locale. This method will return useful values for roles that fall outside the enumeration used in atspi_accessible_getRole ().
atspi_accessible_get_name
Gets the name of an AtspiAccessible object.
atspi_accessible_get_object_locale
atspi_accessible_get_parent
Gets an AtspiAccessible object’s parent container.
atspi_accessible_get_process_id
Returns the process id associated with the given accessible. Mainly added for debugging; it is a shortcut to explicitly querying the accessible’s app->bus_name and then calling GetConnectionUnixProcessID.
atspi_accessible_get_relation_set
Gets the set of AtspiRelation objects which describes this AtspiAccessible object’s
relationships with other AtspiAccessible objects.
atspi_accessible_get_role
Gets the UI role played by an AtspiAccessible object.
This role’s name can be obtained via atspi_accessible_get_role_name ().
atspi_accessible_get_role_name
Gets a UTF-8 string corresponding to the name of the role played by an object. This method will return useful values for roles that fall outside the enumeration used in atspi_accessible_get_role ().
atspi_accessible_get_selection
Gets the AtspiSelection interface for an AtspiAccessible.
Deprecated since: 2.10
atspi_accessible_get_selection_iface
Gets the AtspiSelection interface for an AtspiAccessible.
atspi_accessible_get_state_set
Gets the states currently held by an object.
atspi_accessible_get_table
Gets the AtspiTable interface for an AtspiAccessible.
Deprecated since: 2.10
atspi_accessible_get_table_cell
Gets the AtspiTableCell interface for an AtspiAccessible.
atspi_accessible_get_table_iface
Gets the AtspiTable interface for an AtspiAccessible.
atspi_accessible_get_text
Gets the AtspiTable interface for an AtspiAccessible.
Deprecated since: 2.10
atspi_accessible_get_text_iface
Gets the AtspiTable interface for an AtspiAccessible.
atspi_accessible_get_toolkit_name
Gets the toolkit name for an AtspiAccessible object.
Only works on application root objects.
atspi_accessible_get_toolkit_version
Gets the toolkit version for an AtspiAccessible object.
Only works on application root objects.
atspi_accessible_get_value
Gets the AtspiTable interface for an AtspiAccessible.
Deprecated since: 2.10
atspi_accessible_get_value_iface
Gets the AtspiTable interface for an AtspiAccessible.
atspi_accessible_set_cache_mask
Sets the type of data to cache for accessibles. If this is not set for an application or is reset to ATSPI_CACHE_UNDEFINED, then the desktop’s cache flag will be used. If the desktop’s cache flag is also undefined, then all possible data will be cached. This function is intended to work around bugs in toolkits where the proper events are not raised / to aid in testing for such bugs.
Methods inherited from AtspiAction (8)
atspi_action_do_action
Invoke the action indicated by #index.
atspi_action_get_action_description
Get the description of ‘i-th’ action invocable on an
object implementing AtspiAction.
atspi_action_get_action_name
Get the name of the ‘i-th’ action invocable on an
object implementing AtspiAction.
atspi_action_get_description
Get the description of ‘i-th’ action invocable on an
object implementing AtspiAction.
Deprecated since: 2.10
atspi_action_get_key_binding
Get the keybindings for the i-th action invocable on an
object implementing AtspiAction, if any are defined.
The keybindings string format is as follows:
there are multiple parts to a keybinding string (typically 3).
They are delimited with “;”. The first is the action’s
keybinding which is usable if the object implementing the action
is currently posted to the screen, e.g. if a menu is posted
then these keybindings for the corresponding menu-items are
available. The second keybinding substring is the full key sequence
necessary to post the action’s widget and activate it, e.g. for
a menu item such as “File->Open” it would both post the menu and
activate the item. Thus the second keybinding string is available
during the lifetime of the containing toplevel window as a whole,
whereas the first keybinding string only works while the object
implementing AtkAction is posted. The third (and optional)
keybinding string is the “keyboard shortcut” which invokes the
action without posting any menus.
Meta-keys are indicated by the conventional strings
“<Control>”, “<Alt>”, “<Shift>”, “<Mod2>”,
etc. (we use the same string as gtk_accelerator_name() in gtk+-2.X.
atspi_action_get_localized_name
Get the name of the ‘i-th’ action invocable on an
object implementing AtspiAction.
atspi_action_get_n_actions
Get the number of actions invokable on an AtspiAction implementor.
atspi_action_get_name
Get the name of the ‘i-th’ action invocable on an
object implementing AtspiAction.
Deprecated since: 2.10
Methods inherited from AtspiCollection (5)
atspi_collection_get_active_descendant
atspi_collection_get_matches
Gets all AtspiAccessible objects from the collection matching a given
rule.
atspi_collection_get_matches_from
Gets all AtspiAccessible objects from the collection, before
current_object, matching a given rule.
atspi_collection_get_matches_to
Gets all AtspiAccessible objects from the collection, after
current_object, matching a given rule.
atspi_collection_is_ancestor_of
Not yet implemented.
Methods inherited from AtspiComponent (14)
atspi_component_contains
Queries whether a given AtspiComponent contains a particular point.
atspi_component_get_accessible_at_point
Gets the accessible child at a given coordinate within an AtspiComponent.
atspi_component_get_alpha
Gets the opacity/alpha value of a component, if alpha blending is in use.
atspi_component_get_extents
Gets the bounding box of the specified AtspiComponent.
The returned values are meaningful only if the Component has both
STATE_VISIBLE and STATE_SHOWING.
atspi_component_get_layer
Queries which layer the component is painted into, to help determine its visibility in terms of stacking order.
atspi_component_get_mdi_z_order
Queries the z stacking order of a component which is in the MDI or window layer. (Bigger z-order numbers mean nearer the top)
atspi_component_get_position
Gets the minimum x and y coordinates of the specified AtspiComponent.
The returned values are meaningful only if the Component has both
STATE_VISIBLE and STATE_SHOWING.
atspi_component_get_size
Gets the size of the specified AtspiComponent.
The returned values are meaningful only if the Component has both
STATE_VISIBLE and STATE_SHOWING.
atspi_component_grab_focus
Attempts to set the keyboard input focus to the specified
AtspiComponent.
atspi_component_scroll_to
Scrolls whatever container of the AtspiComponent object so it becomes
visible on the screen.
atspi_component_scroll_to_point
Scrolls whatever container of the AtspiComponent object so it becomes
visible on the screen at a given position.
atspi_component_set_extents
Moves and resizes the specified component.
atspi_component_set_position
Moves the component to the specified position.
atspi_component_set_size
Resizes the specified component to the given pixel dimensions.
Methods inherited from AtspiDocument (7)
atspi_document_get_attribute_value
Gets the value of a single attribute, if specified for the document as a whole.
Deprecated since: 2.10
atspi_document_get_attributes
Gets all constant attributes for the document as a whole. For attributes
that change within the document content, see atspi_text_get_attribute_run instead.
Deprecated since: 2.10
atspi_document_get_current_page_number
Gets the current page number of an AccessibleDocument object.
atspi_document_get_document_attribute_value
Gets the value of a single attribute, if specified for the document as a whole.
atspi_document_get_document_attributes
Gets all constant attributes for the document as a whole. For attributes
that change within the document content, see atspi_text_get_attribute_run instead.
atspi_document_get_locale
Gets the locale associated with the document’s content, e.g. the locale for LOCALE_TYPE_MESSAGES.
atspi_document_get_page_count
Gets the page count of an AccessibleDocument object.
Methods inherited from AtspiEditableText (6)
atspi_editable_text_copy_text
Copies text from an AtspiEditableText object into the system clipboard.
atspi_editable_text_cut_text
Deletes text from an AtspiEditableText object, copying the
excised portion into the system clipboard.
atspi_editable_text_delete_text
Deletes text from an AtspiEditableText object, without copying the
excised portion into the system clipboard.
atspi_editable_text_insert_text
Inserts text into an AtspiEditableText object.
As with all character offsets, the specified position may not be the
same as the resulting byte offset, since the text is in a
variable-width encoding.
atspi_editable_text_paste_text
Inserts text from the system clipboard into an AtspiEditableText object.
As with all character offsets, the specified position may not be the
same as the resulting byte offset, since the text is in a
variable-width encoding.
atspi_editable_text_set_text_contents
Replace the entire text contents of an AtspiEditableText object.
Methods inherited from AtspiHypertext (3)
atspi_hypertext_get_link
Gets the AtspiHyperlink object at a specified index.
atspi_hypertext_get_link_index
Gets the index of the AtspiHyperlink object at a specified
character offset.
atspi_hypertext_get_n_links
Gets the total number of AtspiHyperlink objects that an
AtspiHypertext implementor has.
Methods inherited from AtspiImage (5)
atspi_image_get_image_description
Gets the description of the image displayed in an AtspiImage object.
atspi_image_get_image_extents
Gets the bounding box of the image displayed in a
specified AtspiImage implementor.
The returned values are meaningful only if the Image has both
STATE_VISIBLE and STATE_SHOWING.
atspi_image_get_image_locale
Gets the locale associated with an image and its textual representation.
atspi_image_get_image_position
Gets the minimum x and y coordinates of the image displayed in a
specified AtspiImage implementor.
The returned values are meaningful only if the Image has both
STATE_VISIBLE and STATE_SHOWING.
atspi_image_get_image_size
Gets the size of the image displayed in a specified AtspiImage object.
The returned values are meaningful only if the Image has both
STATE_VISIBLE and STATE_SHOWING.
Methods inherited from AtspiSelection (8)
atspi_selection_clear_selection
Clears the current selection, removing all selected children from the
specified AtspiSelection implementor’s selection list.
atspi_selection_deselect_child
Deselects a specific child of an AtspiSelection.
Note that child_index is the index of the child
in the parent container.
atspi_selection_deselect_selected_child
Removes a child from the selected children list of an AtspiSelection.
Note that child_index is the index in the selected-children list,
not the index in the parent container. selectedChildIndex in this
method, and child_index in #atspi_selection_select_child
are asymmetric.
atspi_selection_get_n_selected_children
Gets the number of children of an AtspiSelection implementor which are
currently selected.
atspi_selection_get_selected_child
Gets the i-th selected AtspiAccessible child of an AtspiSelection.
Note that selected_child_index refers to the index in the list
of ‘selected’
children and generally differs from that used in
#atspi_accessible_get_child_at_index or returned by
#atspi_accessible_get_index_in_parent.
selected_child_index must lie between 0
and #atspi_selection_get_n_selected_children - 1, inclusive.
atspi_selection_is_child_selected
Determines whether a particular child of an AtspiSelection implementor
is currently selected. Note that child_index is the index into the
standard AtspiAccessible container’s list of children.
atspi_selection_select_all
Attempts to select all of the children of an AtspiSelection implementor.
Not all AtspiSelection implementors support this operation.
atspi_selection_select_child
Adds a child to the selected children list of an AtspiSelection.
For AtspiSelection implementors that only allow
single selections, this may replace the (single) current selection.
Methods inherited from AtspiTable (26)
atspi_table_add_column_selection
Selects the specified column, adding it to the current column selection. Not all tables support column selection.
atspi_table_add_row_selection
Selects the specified row, adding it to the current row selection. Not all tables support row selection.
atspi_table_get_accessible_at
Gets the table cell at the specified row and column indices. To get the accessible object at a particular (x, y) screen coordinate, use #atspi_component_get_accessible_at_point.
atspi_table_get_caption
Gets an accessible representation of the caption for an AtspiTable.
atspi_table_get_column_at_index
Gets the table column index occupied by the child at a particular 1-D child index.
atspi_table_get_column_description
Gets a text description of a particular table column. This differs from
atspi_table_get_column_header, which returns an Accessible.
atspi_table_get_column_extent_at
Gets the number of columns spanned by the table cell at the specific row and column (some tables can have cells which span multiple rows and/or columns). The returned values are meaningful only if the Table has both STATE_VISIBLE and STATE_SHOWING.
atspi_table_get_column_header
Gets the header associated with a table column, if available. This differs from #atspi_table_get_column_description, which returns a string.
atspi_table_get_index_at
Gets the 1-D child index corresponding to the specified 2-D row and column indices. To get the accessible object at a particular (x, y) screen coordinate, use #atspi_component_get_accessible_at_point.
atspi_table_get_n_columns
Gets the number of columns in an AtspiTable,
exclusive of any columns that are programmatically hidden, but inclusive
of columns that may be outside of the current scrolling window or viewport.
atspi_table_get_n_rows
Gets the number of rows in an AtspiTable,
exclusive of any rows that are programmatically hidden, but inclusive
of rows that may be outside of the current scrolling window or viewport.
atspi_table_get_n_selected_columns
Queries a table to find out how many columns are currently selected. Not all tables support column selection.
atspi_table_get_n_selected_rows
Query a table to find out how many rows are currently selected. Not all tables support row selection.
atspi_table_get_row_at_index
Gets the table row index occupied by the child at a particular 1-D child index.
atspi_table_get_row_column_extents_at_index
Given a child index, determines the row and column indices and
extents, and whether the cell is currently selected. If
the child at index is not a cell (for instance, if it is
a summary, caption, etc.), FALSE is returned.
The returned values are meaningful only if the Table has both
STATE_VISIBLE and STATE_SHOWING.
atspi_table_get_row_description
Gets a text description of a particular table row. This differs from
atspi_table_get_row_header, which returns an AtspiAccessible.
atspi_table_get_row_extent_at
Gets the number of rows spanned by the table cell at the specific row and column. (some tables can have cells which span multiple rows and/or columns). The returned values are meaningful only if the Table has both STATE_VISIBLE and STATE_SHOWING.
atspi_table_get_row_header
Gets the header associated with a table row, if available. This differs from
atspi_table_get_row_description, which returns a string.
atspi_table_get_selected_columns
Queries a table for a list of indices of columns which are currently selected.
atspi_table_get_selected_rows
Queries a table for a list of indices of rows which are currently selected.
atspi_table_get_summary
Gets an accessible object which summarizes the contents of an AtspiTable.
atspi_table_is_column_selected
Determines whether specified table column is selected. Not all tables support column selection.
atspi_table_is_row_selected
Determines whether a table row is selected. Not all tables support row selection.
Methods inherited from AtspiTableCell (8)
atspi_table_cell_get_column_header_cells
Returns the column headers as an array of cell accessibles.
atspi_table_cell_get_column_index
atspi_table_cell_get_column_span
Returns the number of columns occupied by this cell accessible. The returned values are meaningful only if the table cell has both STATE_VISIBLE and STATE_SHOWING.
atspi_table_cell_get_position
Retrieves the tabular position of this cell.
atspi_table_cell_get_row_column_span
Gets the row and column indexes and extents of this cell accessible. The returned values are meaningful only if the table cell has both STATE_VISIBLE and STATE_SHOWING.
atspi_table_cell_get_row_header_cells
Returns the row headers as an array of cell accessibles.
atspi_table_cell_get_row_span
Returns the number of rows occupied by this cell accessible. The returned values are meaningful only if the table cell has both STATE_VISIBLE and STATE_SHOWING.
atspi_table_cell_get_table
Returns a reference to the accessible of the containing table.
Methods inherited from AtspiText (26)
atspi_text_add_selection
Selects some text (adds a text selection) in an AtspiText object.
atspi_text_get_attribute_run
Gets a set of attributes applied to a range of text from an AtspiText object, optionally
including its ‘default’ attributes.
atspi_text_get_attribute_value
Gets the value of a named attribute at a given offset.
Deprecated since: 2.10
atspi_text_get_attributes
Gets the attributes applied to a range of text from an AtspiText
object. The text attributes correspond to CSS attributes
where possible.
Deprecated since: 2.10
atspi_text_get_bounded_ranges
Gets the ranges of text from an AtspiText object which lie within the
bounds defined by (x, y) and (x+width, y+height).
atspi_text_get_caret_offset
Gets the current offset of the text caret in an AtspiText object.
atspi_text_get_character_at_offset
Gets the character at a given offset for an AtspiText object.
atspi_text_get_character_count
Gets the character count of an AccessibleText object.
atspi_text_get_character_extents
Gets a bounding box containing the glyph representing the character at a particular text offset. The returned values are meaningful only if the Text has both STATE_VISIBLE and STATE_SHOWING.
atspi_text_get_default_attributes
Gets the default attributes applied to an AtspiText
object. The text attributes correspond to CSS attributes
where possible. The combination of this attribute set and
the attributes reported by #atspi_text_get_attributes
describes the entire set of text attributes over a range.
atspi_text_get_n_selections
Gets the number of active non-contiguous selections for an
AtspiText object.
atspi_text_get_offset_at_point
Gets the character offset into the text at a given point.
atspi_text_get_range_extents
Gets the bounding box for text within a range in an AtspiText object.
The returned values are meaningful only if the Text has both
STATE_VISIBLE and STATE_SHOWING.
atspi_text_get_selection
Gets the bounds of the selection_num-th active text selection for an
AtspiText object.
atspi_text_get_string_at_offset
Gets a portion of the text exposed through an AtspiText according to a given offset
and a specific granularity, along with the start and end offsets defining the
boundaries of such a portion of text.
Available since: 2.9.90
atspi_text_get_text
Gets a range of text from an AtspiText object. The number of bytes
in the returned string may exceed either end_offset or start_offset, since
UTF-8 is a variable-width encoding.
atspi_text_get_text_after_offset
Gets delimited text from an AtspiText object which follows a given
text offset.
atspi_text_get_text_at_offset
Gets delimited text from an AtspiText object which includes a given
text offset.
Deprecated since: 2.10
atspi_text_get_text_attribute_value
Gets the value of a named attribute at a given offset.
atspi_text_get_text_attributes
Gets the attributes applied to a range of text from an AtspiText
object. The text attributes correspond to CSS attributes
where possible.
atspi_text_get_text_before_offset
Gets delimited text from an AtspiText object which precedes a given
text offset.
atspi_text_remove_selection
De-selects a text selection.
atspi_text_scroll_substring_to
Scrolls whatever container of the AtspiText text range so it becomes
visible on the screen.
Methods inherited from AtspiValue (6)
atspi_value_get_current_value
Gets the current value for an AtspiValue.
atspi_value_get_maximum_value
Gets the maximum allowed value for an AtspiValue.
atspi_value_get_minimum_increment
Gets the minimum increment by which an AtspiValue can be adjusted.
atspi_value_get_minimum_value
Gets the minimum allowed value for an AtspiValue.
atspi_value_get_text
Gets the human readable text alternative associated with the value.
text is a newly created string, that must be freed by the
caller. Can be NULL if no descriptor is available.
Available since: 2.46
atspi_value_set_current_value
Sets the current value of an AtspiValue.
Signals
Atspi.Accessible::mode-changed
The signal “mode-changed” is emitted by a screen reader to indicate that its mode has changed. This signal supports the following details: focus-tracking flat-review mouse-review say-all caret-tracking.
Atspi.Accessible::region-changed
The signal “region-changed” is emitted by a screen reader to indicate that it is now reading or tracking a new object, or, a new piece of text within an object. This allows a magnifier to gain the information needed to highlight the object that the screen reader is reading.
Class structure
struct AtspiAccessibleClass {
AtspiObjectClass parent_class;
void (* region_changed) (
AtspiAccessible* accessible,
gint current_offset,
gint last_offset
);
void (* mode_changed) (
AtspiAccessible* accessible,
gboolean enabled
);
}Class members
parent_class |
|
| No description available. | |
region_changed |
|
| No description available. | |
mode_changed |
|
| No description available. |