LibreOffice
LibreOffice 24.2 SDK API Reference
|
Implement this interface to give access to a two-dimensional table. More...
import"XAccessibleTable.idl";
Public Member Functions | |
long | getAccessibleRowCount () |
Returns the number of used rows in the table. More... | |
long | getAccessibleColumnCount () |
Returns the number of used columns in the table. More... | |
string | getAccessibleRowDescription ([in] long nRow) raises (::com::sun::star::lang::IndexOutOfBoundsException) |
Returns the description text of the specified row in the table. More... | |
string | getAccessibleColumnDescription ([in] long nColumn) raises (::com::sun::star::lang::IndexOutOfBoundsException) |
Returns the description text of the specified column in the table. More... | |
long | getAccessibleRowExtentAt ([in] long nRow, [in] long nColumn) raises (::com::sun::star::lang::IndexOutOfBoundsException) |
Returns the number of rows occupied by the Accessible at the specified row and column in the table. More... | |
long | getAccessibleColumnExtentAt ([in] long nRow, [in] long nColumn) raises (::com::sun::star::lang::IndexOutOfBoundsException) |
Returns the number of columns occupied by the Accessible at the specified row and column in the table. More... | |
XAccessibleTable | getAccessibleRowHeaders () |
Returns the row headers as an XAccessibleTable object. More... | |
XAccessibleTable | getAccessibleColumnHeaders () |
Returns the column headers as an XAccessibleTable object. More... | |
sequence< long > | getSelectedAccessibleRows () |
Returns a list of the indices of completely selected rows in a table. More... | |
sequence< long > | getSelectedAccessibleColumns () |
Returns a list of the indices of completely selected columns in a table. More... | |
boolean | isAccessibleRowSelected ([in] long nRow) raises (::com::sun::star::lang::IndexOutOfBoundsException) |
Returns a boolean value indicating whether the specified row is completely selected. More... | |
boolean | isAccessibleColumnSelected ([in] long nColumn) raises (::com::sun::star::lang::IndexOutOfBoundsException) |
Returns a boolean value indicating whether the specified column is completely selected. More... | |
XAccessible | getAccessibleCellAt ([in] long nRow, [in] long nColumn) raises (::com::sun::star::lang::IndexOutOfBoundsException) |
Returns the XAccessible object at the specified row and column in the table. More... | |
XAccessible | getAccessibleCaption () |
Returns the caption for the table. More... | |
XAccessible | getAccessibleSummary () |
Returns the summary description of the table. More... | |
boolean | isAccessibleSelected ([in] long nRow, [in] long nColumn) raises (::com::sun::star::lang::IndexOutOfBoundsException) |
Returns a boolean value indicating whether the accessible at the specified row and column is selected. More... | |
hyper | getAccessibleIndex ([in] long nRow, [in] long nColumn) raises (::com::sun::star::lang::IndexOutOfBoundsException) |
Returns the child index of the accessible object that spans the specified cell. More... | |
long | getAccessibleRow ([in] hyper nChildIndex) raises (::com::sun::star::lang::IndexOutOfBoundsException) |
Translate the given child index into the corresponding row index. More... | |
long | getAccessibleColumn ([in] hyper nChildIndex) raises (::com::sun::star::lang::IndexOutOfBoundsException) |
Translate the given child index into the corresponding column index. More... | |
Public Member Functions inherited from XInterface | |
any | queryInterface ([in] type aType) |
queries for a new interface to an existing UNO object. More... | |
void | acquire () |
increases the reference counter by one. More... | |
void | release () |
decreases the reference counter by one. More... | |
Implement this interface to give access to a two-dimensional table.
The XAccessibleTable interface is used to represent two-dimensional tables. This interface combines the two interfaces javax.accessibility.AccessibleTable
and javax.accessibility.AccessibleExtendedTable
of the Java Accessibility API (version 1.4).
All XAccessible objects that represent cells or cell-clusters of a table have to be at the same time children of the table. This is necessary to be able to convert row and column indices into child indices and vice versa with the methods XAccessibleTable::getAccessibleIndex(), XAccessibleTable::getAccessibleRow(), and XAccessibleTable::getAccessibleColumn().
The range of valid coordinates for this interface are implementation dependent. However, that range includes at least the intervals from the first row or column with the index 0 up to the last (but not including) used row or column as returned by XAccessibleTable::getAccessibleRowCount() and XAccessibleTable::getAccessibleColumnCount(). In case of Calc the current range of valid indices for retrieving data include the maximum table size minus one.
XAccessible getAccessibleCaption | ( | ) |
Returns the caption for the table.
XAccessible getAccessibleCellAt | ( | [in] long | nRow, |
[in] long | nColumn | ||
) | |||
raises | ( | ::com::sun::star::lang::IndexOutOfBoundsException | |
) |
Returns the XAccessible object at the specified row and column in the table.
This method has been renamed from the Java name getAccessibleAt
to XAccessibleTable::getAccessibleCellAt() to avoid ambiguities with the XAccessibleComponent::getAccessibleAt() method when accessed, for instance, from StarBasic.
nRow | The row index for which to retrieve the cell. |
nColumn | The column index for which to retrieve the cell. |
com::sun::star::lang::IndexOutOfBoundsException | if the specified column and/or row index is not valid, i.e. lies not inside the valid range of 0 up to XAccessibleTable::getAccessibleColumnCount() - 1. |
long getAccessibleColumn | ( | [in] hyper | nChildIndex | ) | |
raises | ( | ::com::sun::star::lang::IndexOutOfBoundsException | |||
) |
Translate the given child index into the corresponding column index.
nChildIndex | Index of the child of the table for which to return the column index. |
com::sun::star::lang::IndexOutOfBoundsException | if nChildIndex addresses an invalid column. |
long getAccessibleColumnCount | ( | ) |
Returns the number of used columns in the table.
The implementation, however, may allow the access of columns beyond this number.
string getAccessibleColumnDescription | ( | [in] long | nColumn | ) | |
raises | ( | ::com::sun::star::lang::IndexOutOfBoundsException | |||
) |
Returns the description text of the specified column in the table.
nColumn | The index of the column for which to retrieve the description. |
com::sun::star::lang::IndexOutOfBoundsException | if the specified column index is not valid, i.e. lies not inside the valid range of 0 up to XAccessibleTable::getAccessibleColumnCount() - 1. |
long getAccessibleColumnExtentAt | ( | [in] long | nRow, |
[in] long | nColumn | ||
) | |||
raises | ( | ::com::sun::star::lang::IndexOutOfBoundsException | |
) |
Returns the number of columns occupied by the Accessible at the specified row and column in the table.
The result differs from 1 if the specified cell spans multiple columns.
nRow | Row index of the accessible for which to return the column extent. |
nColumn | Column index of the accessible for which to return the column extent. |
com::sun::star::lang::IndexOutOfBoundsException | if the specified column index is not valid, i.e. lies not inside the valid range of 0 up to XAccessibleTable::getAccessibleColumnCount() - 1. |
XAccessibleTable getAccessibleColumnHeaders | ( | ) |
Returns the column headers as an XAccessibleTable object.
Content and size of the returned table are implementation dependent.
hyper getAccessibleIndex | ( | [in] long | nRow, |
[in] long | nColumn | ||
) | |||
raises | ( | ::com::sun::star::lang::IndexOutOfBoundsException | |
) |
Returns the child index of the accessible object that spans the specified cell.
This is the same index that would be returned by calling XAccessibleContext::getAccessibleIndexInParent() for that accessible object.
nRow | Row index of the accessible object for which to return the child index. |
nColumn | Row index of the accessible object for which to return the child index. |
long getAccessibleRow | ( | [in] hyper | nChildIndex | ) | |
raises | ( | ::com::sun::star::lang::IndexOutOfBoundsException | |||
) |
Translate the given child index into the corresponding row index.
nChildIndex | Index of the child of the table for which to return the row index. |
com::sun::star::lang::IndexOutOfBoundsException | if nChildIndex addresses an invalid row. |
long getAccessibleRowCount | ( | ) |
Returns the number of used rows in the table.
The implementation, however, may allow the access of columns beyond this number.
string getAccessibleRowDescription | ( | [in] long | nRow | ) | |
raises | ( | ::com::sun::star::lang::IndexOutOfBoundsException | |||
) |
Returns the description text of the specified row in the table.
nRow | The index of the row for which to retrieve the description. |
com::sun::star::lang::IndexOutOfBoundsException | if the specified row index is not valid, i.e. lies not inside the valid range of 0 up to XAccessibleTable::getAccessibleRowCount() - 1. |
long getAccessibleRowExtentAt | ( | [in] long | nRow, |
[in] long | nColumn | ||
) | |||
raises | ( | ::com::sun::star::lang::IndexOutOfBoundsException | |
) |
Returns the number of rows occupied by the Accessible at the specified row and column in the table.
The result differs from 1 if the specified cell spans multiple rows.
nRow | Row index of the accessible for which to return the column extent. |
nColumn | Column index of the accessible for which to return the column extent. |
com::sun::star::lang::IndexOutOfBoundsException | if the specified row index is not valid, i.e. lies not inside the valid range of 0 up to XAccessibleTable::getAccessibleRowCount() - 1. |
XAccessibleTable getAccessibleRowHeaders | ( | ) |
Returns the row headers as an XAccessibleTable object.
Content and size of the returned table are implementation dependent.
XAccessible getAccessibleSummary | ( | ) |
Returns the summary description of the table.
sequence<long> getSelectedAccessibleColumns | ( | ) |
Returns a list of the indices of completely selected columns in a table.
sequence<long> getSelectedAccessibleRows | ( | ) |
Returns a list of the indices of completely selected rows in a table.
boolean isAccessibleColumnSelected | ( | [in] long | nColumn | ) | |
raises | ( | ::com::sun::star::lang::IndexOutOfBoundsException | |||
) |
Returns a boolean value indicating whether the specified column is completely selected.
nColumn | Index of the column for which to determine whether it is selected. |
TRUE
if the specified column is selected completely and FALSE
otherwise.com::sun::star::lang::IndexOutOfBoundsException | if the specified column index is not valid, i.e. lies not inside the valid range of 0 up to XAccessibleTable::getAccessibleColumnCount() - 1. |
boolean isAccessibleRowSelected | ( | [in] long | nRow | ) | |
raises | ( | ::com::sun::star::lang::IndexOutOfBoundsException | |||
) |
Returns a boolean value indicating whether the specified row is completely selected.
nRow | Index of the row for which to determine whether it is selected. |
TRUE
if the specified row is selected completely and FALSE
otherwise.com::sun::star::lang::IndexOutOfBoundsException | if the specified row index is not valid, i.e. lies not inside the valid range of 0 up to XAccessibleTable::getAccessibleRowCount() - 1. |
boolean isAccessibleSelected | ( | [in] long | nRow, |
[in] long | nColumn | ||
) | |||
raises | ( | ::com::sun::star::lang::IndexOutOfBoundsException | |
) |
Returns a boolean value indicating whether the accessible at the specified row and column is selected.
nRow | Row index of the cell for which to determine if the accessible object that spans that cell is selected. |
nColumn | Column index of the cell for which to determine if the accessible object that spans that cell is selected. |
TRUE
if the given row and column indices are valid and the specified accessible object is selected. Otherwise FALSE
is returned.