Atspi.Table¶
- Implementations:
Methods¶
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Virtual Methods¶
None
Properties¶
None
Signals¶
None
Fields¶
None
Class Details¶
- class Atspi.Table¶
- Bases:
An interface used by containers whose data is arranged in a tabular form.
An interface used by containers whose contained data is arranged in a tabular (i.e. row-column) form. Tables may resemble a two-dimensional grid, as in a spreadsheet, or may feature objects which span multiple rows and/or columns, but whose bounds are aligned on a row/column matrix. Objects within tables are children of the table object, and they may be referenced either via a child index or via a row/column pair. Table ‘cells’ may implement other interfaces, such as Text, Action, Image, and Component, and should do so as appropriate to their onscreen presentation and/or behavior.
- add_column_selection(column)¶
- Parameters:
column (
int
) – the zero-indexed column number of the column being selected.- Raises:
- Returns:
True
if the specified column was successfully selected,False
if not.- Return type:
Selects the specified column, adding it to the current column selection. Not all tables support column selection.
- add_row_selection(row)¶
- Parameters:
row (
int
) – the zero-indexed row number of the row being selected.- Raises:
- Returns:
True
if the specified row was successfully selected,False
if not.- Return type:
Selects the specified row, adding it to the current row selection. Not all tables support row selection.
- get_accessible_at(row, column)¶
- Parameters:
- Raises:
- Returns:
an
Atspi.Accessible
object representing the specified table cell.- Return type:
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
.
- Raises:
- Returns:
an
Atspi.Accessible
object that serves as the table’s caption.- Return type:
Gets an accessible representation of the caption for an
Atspi.Table
.
- get_column_at_index(index)¶
- Parameters:
index (
int
) – the specified child index, zero-indexed.- Raises:
- Returns:
a
int
indicating the first column spanned by the child of a table, at the specified 1-D (zero-offset) index.- Return type:
Gets the table column index occupied by the child at a particular 1-D child index.
- get_column_description(column)¶
- Parameters:
column (
int
) – the specified table column, zero-indexed.- Raises:
- Returns:
a UTF-8 string describing the specified table column, if available.
- Return type:
Gets a text description of a particular table column. This differs from
Atspi.Table.get_column_header
, which returns an #Accessible.
- get_column_extent_at(row, column)¶
- Parameters:
- Raises:
- Returns:
a
int
indicating the number of columns spanned by the specified cell.- Return type:
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.
- get_column_header(column)¶
- Parameters:
column (
int
) – the specified table column, zero-indexed.- Raises:
- Returns:
an
Atspi.Accessible
representation of the specified table column, if available.- Return type:
Gets the header associated with a table column, if available. This differs from
Atspi.Table.get_column_description
, which returns a string.
- get_index_at(row, column)¶
- Parameters:
- Raises:
- Returns:
a
int
which serves as the index of a specified cell in the table, in a form usable by #atspi_get_child_at_index.- Return type:
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
.see
Atspi.Table.get_row_at_index
,Atspi.Table.get_column_at_index
- get_n_columns()¶
- Raises:
- Returns:
a
int
indicating the number of columns in the table.- Return type:
Gets the number of columns in an
Atspi.Table
, exclusive of any columns that are programmatically hidden, but inclusive of columns that may be outside of the current scrolling window or viewport.
- get_n_rows()¶
- Raises:
- Returns:
a
int
indicating the number of rows in the table.- Return type:
Gets the number of rows in an
Atspi.Table
, exclusive of any rows that are programmatically hidden, but inclusive of rows that may be outside of the current scrolling window or viewport.
- get_n_selected_columns()¶
- Raises:
- Returns:
a
int
indicating the number of columns currently selected.- Return type:
Queries a table to find out how many columns are currently selected. Not all tables support column selection.
- get_n_selected_rows()¶
- Raises:
- Returns:
a
int
indicating the number of rows currently selected.- Return type:
Query a table to find out how many rows are currently selected. Not all tables support row selection.
- get_row_at_index(index)¶
- Parameters:
index (
int
) – the specified child index, zero-indexed.- Raises:
- Returns:
a
int
indicating the first row spanned by the child of a table, at the specified 1-D (zero-offset) index.- Return type:
Gets the table row index occupied by the child at a particular 1-D child index.
see
Atspi.Table.get_index_at
,Atspi.Table.get_column_at_index
- get_row_column_extents_at_index(index)¶
- Parameters:
index (
int
) – the index of theAtspi.Table
child whose row/column extents are requested.- Raises:
- Returns:
True
if the index is associated with a valid table cell,False
if the index does not correspond to a cell. IfFalse
is returned, the values of the out parameters are undefined.- row:
back-filled with the first table row associated with the cell with child index.
- col:
back-filled with the first table column associated with the cell with child index.
- row_extents:
back-filled with the number of table rows across which child i extends.
- col_extents:
back-filled with the number of table columns across which child i extends.
- is_selected:
a boolean which is back-filled with
True
if the child at index i corresponds to a selected table cell,False
otherwise.
- Return type:
(
bool
, row:int
, col:int
, row_extents:int
, col_extents:int
, is_selected:bool
)
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.Example: If the
Atspi.Table
child at index ‘6’ extends across columns 5 and 6 of row 2 of anAtspi.Table
instance, and is currently selected, thenretval =
Atspi.Table.get_row_column_extents_at_index
(table, 6, row, col, row_extents, col_extents, is_selected);will return
True
, and after the call row, col, row_extents, col_extents, and is_selected will contain 2, 5, 1, 2, andTrue
, respectively.
- get_row_description(row)¶
- Parameters:
row (
int
) – the specified table row, zero-indexed.- Raises:
- Returns:
a UTF-8 string describing the specified table row, if available.
- Return type:
Gets a text description of a particular table row. This differs from
Atspi.Table.get_row_header
, which returns anAtspi.Accessible
.
- get_row_extent_at(row, column)¶
- Parameters:
- Raises:
- Returns:
a
int
indicating the number of rows spanned by the specified cell.- Return type:
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.
- get_row_header(row)¶
- Parameters:
row (
int
) – the specified table row, zero-indexed.- Raises:
- Returns:
an
Atspi.Accessible
representation of the specified table row, if available.- Return type:
Gets the header associated with a table row, if available. This differs from
Atspi.Table.get_row_description
, which returns a string.
- get_selected_columns()¶
- Raises:
- Returns:
an array of
int
values, specifying which columns are currently selected.- Return type:
[
int
]
Queries a table for a list of indices of columns which are currently selected.
- get_selected_rows()¶
- Raises:
- Returns:
an array of
int
values, specifying which rows are currently selected.- Return type:
[
int
]
Queries a table for a list of indices of rows which are currently selected.
- get_summary()¶
- Raises:
- Returns:
an
Atspi.Accessible
object that serves as the table’s summary (often a reducedAtspi.Table
).- Return type:
Gets an accessible object which summarizes the contents of an
Atspi.Table
.
- is_column_selected(column)¶
- Parameters:
column (
int
) – the zero-indexed column number of the column being queried.- Raises:
- Returns:
True
if the specified column is currently selected,False
if not.- Return type:
Determines whether specified table column is selected. Not all tables support column selection.
- is_row_selected(row)¶
- Parameters:
row (
int
) – the zero-indexed row number of the row being queried.- Raises:
- Returns:
True
if the specified row is currently selected,False
if not.- Return type:
Determines whether a table row is selected. Not all tables support row selection.
- is_selected(row, column)¶
- Parameters:
- Raises:
- Returns:
True
if the specified cell is currently selected,False
if not.- Return type:
Determines whether the cell at a specific row and column is selected.
- remove_column_selection(column)¶
- Parameters:
column (
int
) – the zero-indexed column number of the column being de-selected.- Raises:
- Returns:
True
if the specified column was successfully de-selected,False
if not.- Return type:
De-selects the specified column, removing it from the current column selection. Not all tables support column selection.
- remove_row_selection(row)¶
- Parameters:
row (
int
) – the zero-indexed number of the row being de-selected.- Raises:
- Returns:
True
if the specified row was successfully de-selected,False
if not.- Return type:
De-selects the specified row, removing it from the current row selection. Not all tables support row selection.