get_row_column_extents_at_index


Description:

public bool get_row_column_extents_at_index (int index, out int row, out int col, out int row_extents, out int col_extents, out bool is_selected) throws Error

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 Table child at index '6' extends across columns 5 and 6 of row 2 of an Table instance, and is currently selected, then

retval = 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, and TRUE , respectively.

Parameters:

this

a pointer to the Table implementor on which to operate.

index

the index of the Table child whose row/column extents are requested.

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.

Returns:

TRUE if the index is associated with a valid table cell, FALSE if the index does not correspond to a cell. If FALSE is returned, the values of the out parameters are undefined.