Xfce Foundation Classes
Main Page  | IndexNamespace List  |  Alphabetical List  |  Class List  |  File List


Public Member Functions | Static Protected Attributes
Xfc::Atk::Table Class Reference

An AtkTable C++ wrapper class. More...

#include <xfc/atk/table.hh>

Inheritance diagram for Xfc::Atk::Table:
Xfc::G::TypeInterface Xfc::G::TypeInstance Xfc::Trackable

List of all members.

Public Member Functions

Accessors

Protected Member Functions

Constructors

Static Protected Attributes


Detailed Description

An AtkTable C++ wrapper class.

Table should be implemented by components which present elements ordered via rows and columns. It may also be used to present tree-structured information if the nodes of the trees can be said to contain multiple "columns". Individual elements of an Table are typically referred to as "cells", and these cells are exposed by Table as child Atk::Objects of the Table. Both row/column and child-index-based access to these children is provided.

Children of Table are frequently "lightweight" objects, that is, they may not have backing widgets in the host UI toolkit. They are therefore often transient.

Since tables are often very complex, Table includes provision for offering simplified summary information, as well as row and column headers and captions. Headers and captions are Atk::Objects which may implement other interfaces (Text, Image, etc.) as appropriate. Table summaries may themselves be (simplified) Tables, etc.


Member Function Documentation

Adds the specified column to the selection.

Parameters:
columnAn integer representing a column in the table.
Returns:
true if the column was successfully added to the selection, or false if the table does not implement this interface.

Adds the specified row to the selection.

Parameters:
rowAn integer representing a row in the table.
Returns:
true if the row was successfully added to the selection, or false if the table does not implement this interface.

Gets the caption for the table.

Returns:
A pointer to an Atk::Object representing the table caption, or null if table does not implement this interface.
int Xfc::Atk::Table::get_column_at_index ( int  index) const

Gets an integer representing the column at the specified index.

Parameters:
indexAn integer representing an index in the table.
Returns:
An integer representing the column at the specified index, or or -1 if the table does not implement this interface.

Gets the description text of the specified column in the table.

Parameters:
columnAn integer representing a column in the table.
Returns:
A string representing the column description, or a null String if the table does not implement this interface.
int Xfc::Atk::Table::get_column_extent_at ( int  row,
int  column 
) const

Gets the number of columns occupied by the accessible object at the specified row and column in the table.

Parameters:
rowAn integer representing a row in the table.
columnAn integer representing a column in the table.
Returns:
An integer representing the column extent at specified position, or 0 if the table does not implement this interface.

Gets the column header of a specified column in an accessible table.

Parameters:
columnAn integer representing a column in the table.
Returns:
A pointer to an Atk::Object representing the specified column header, or null if table does not implement this interface.
int Xfc::Atk::Table::get_index_at ( int  row,
int  column 
) const

Gets a integer representing the index at the specified row and column.

Parameters:
rowAn integer representing a row in the table.
columnAn integer representing a column in the table.
Returns:
An integer representing the index at specified position.

The value -1 is returned if the object at row, column is not a child of the table or the table does not implement this interface.

Gets the number of columns in the table.

Returns:
An integer representing the number of columns, or 0 if the table does not implement this interface.

Gets the number of rows in the table.

Returns:
An integer representing the number of rows, or 0 if the table does not implement this interface.
int Xfc::Atk::Table::get_row_at_index ( int  index) const

Gets an integer representing the row at the specified index.

Parameters:
indexAn integer representing an index in the table.
Returns:
An integer representing the row at the specified index, or or -1 if the table does not implement this interface.

Gets the description text of the specified row in the table.

Parameters:
rowAn integer representing a row in the table.
Returns:
A string representing the row description, or null if the table does not implement this interface.
int Xfc::Atk::Table::get_row_extent_at ( int  row,
int  column 
) const

Gets the number of rows occupied by the accessible object at the specified row and column in the table.

Parameters:
rowAn integer representing a row in the table.
columnAn integer representing a column in the table.
Returns:
An integer representing the row extent at specified position, or 0 if the table does not implement this interface.

Gets the row header of a specified row in an accessible table.

Parameters:
rowAn integer representing a row in the table.
Returns:
A pointer to an Atk::Object representing the specified row header, or null if table does not implement this interface.
bool Xfc::Atk::Table::get_selected_columns ( std::vector< int > &  selected) const

Gets the selected columns of the table.

Parameters:
selectedA vector of int that is to hold the selected columns numbers.
Returns:
true if the vector is not empty.
bool Xfc::Atk::Table::get_selected_rows ( std::vector< int > &  selected) const

Gets the selected rows of the table.

Parameters:
selectedA vector of int that is to hold the selected rows numbers.
Returns:
true if the vector is not empty.

Gets the summary description of the table.

Returns:
A pointer to an Atk::Object representing a summary description of the table, or null if table does not implement this interface.
bool Xfc::Atk::Table::is_column_selected ( int  column) const

Gets whether the specified column is selected.

Parameters:
columnAn integer representing a column in the table.
Returns:
true if the column is selected, or false if the table does not implement this interface. bool is_row_selected(int row);
bool Xfc::Atk::Table::is_row_selected ( int  row) const

Gets whether the specified row is selected.

Parameters:
rowAn integer representing a row in the table.
Returns:
true if the row is selected, or false if the table does not implement this interface.
bool Xfc::Atk::Table::is_selected ( int  row,
int  column 
) const

Gets a bool value indicating whether the accessible object at the specified row and column is selected.

Parameters:
rowAn integer representing a row in the table.
columnAn integer representing a column in the table.
Returns:
true if the cell is selected, or false if the table does not implement this interface.
Object* Xfc::Atk::Table::ref_at ( int  row,
int  column 
) const

Get a reference to the table cell at row, column.

Parameters:
rowAn integer representing a row in table.
columnan integer representing a column in the table.
Returns:
A pointer to Atk::Object representing the referred to accessible.

Removes the specified column from the selection.

Parameters:
columnAn integer representing a column in the table.
Returns:
true if the column was successfully removed from the selection, or false if the table does not implement this interface.

Removes the specified row from the selection.

Parameters:
rowAn integer representing a row in the table.
Returns:
true if the row was successfully removed from the selection, or false if the table does not implement this interface.
void Xfc::Atk::Table::set_caption ( const Object caption)

Sets the caption for the table.

Parameters:
captionAn Atk::Object representing the caption to set for the table.
void Xfc::Atk::Table::set_column_description ( int  column,
const String description 
)

Sets the description text for the specified column of the table.

Parameters:
columnAn integer representing a column in the table.
descriptionA string representing the description text to set for the specified column of the table.
void Xfc::Atk::Table::set_column_header ( int  column,
const Object header 
)

Sets the specified column header to header.

Parameters:
columnAn integer representing a column in the table.
headerAn Atk::Object representing the specified column header.
void Xfc::Atk::Table::set_row_description ( int  row,
const String description 
)

Sets the description text for the specified row of the table.

Parameters:
rowAn integer representing a row in the table.
descriptionA string representing the description text to set for the specified row of the table.
void Xfc::Atk::Table::set_row_header ( int  row,
const Object header 
)

Sets the specified row header to header.

Parameters:
rowAn integer representing a row in the table.
headerAn Atk::Object representing the specified row header.
void Xfc::Atk::Table::set_summary ( const Object accessible)

Sets the summary description of the table.

Parameters:
accessibleAn Atk::Object representing the summary description to set for table.

Member Data Documentation

Columnn deleted signal (see signal_column_deleted()).

Calls a slot with the signature:

< void function(int column, int num_deleted);
< // column: The index of the first column deleted.
< // num_deleted: The number of columns deleted.
<

Column inserted signal (see signal_column_inserted()).

Calls a slot with the signature:

< void function(int column, int num_inserted);
< // column: The index of the first column inserted.
< // num_inserted: The number of columns inserted.
<

Column reordered signal (see signal_column_reordered()).

Calls a slot with the signature:

< void function();
<

Model changed signal (see signal_model_changed()).

Calls a slot with the signature:

< void function();
<

Row deleted signal (see signal_row_deleted()).

Calls a slot with the signature:

< void function(int row, int num_deleted);
< // row: The index of the first row deleted.
< // num_deleted: The number of rows deleted.
<

Row inserted signal (see signal_row_inserted()).

Calls a slot with the signature:

< void function(int row, int num_inserted);
< // row: The index of the first row inserted.
< // num_inserted: The number of rows inserted.
<

Row reordered signal (see signal_row_reordered()).

Calls a slot with the signature:

< void function();
<

The documentation for this class was generated from the following file:
Xfce Foundation Classes
Copyright © 2004-2005 The XFC Development Team XFC