AtkTable

Name

AtkTable -- a user-interface component that presents data in two-dimensional table format

Synopsis



struct      AtkTable;
struct      AtkTableIface;
AtkObject*  atk_table_ref_at                (AtkTable *table,
                                             gint row,
                                             gint column);
gint        atk_table_get_index_at          (AtkTable *table,
                                             gint row,
                                             gint column);
gint        atk_table_get_row_at_index      (AtkTable *table,
                                             gint index);
gint        atk_table_get_column_at_index   (AtkTable *table,
                                             gint index);
gchar*      atk_table_get_caption           (AtkTable *table);
gint        atk_table_get_n_columns         (AtkTable *table);
gchar*      atk_table_get_column_description
                                            (AtkTable *table,
                                             gint column);
gint        atk_table_get_column_extent_at  (AtkTable *table,
                                             gint row,
                                             gint column);
AtkObject*  atk_table_get_column_header     (AtkTable *table,
                                             gint column);
gint        atk_table_get_n_rows            (AtkTable *table);
gchar*      atk_table_get_row_description   (AtkTable *table,
                                             gint r);
gint        atk_table_get_row_extent_at     (AtkTable *table,
                                             gint row,
                                             gint column);
AtkObject*  atk_table_get_row_header        (AtkTable *table,
                                             gint row);
AtkObject*  atk_table_get_summary           (AtkTable *table);
gint*       atk_table_get_selected_columns  (AtkTable *table);
gint*       atk_table_get_selected_rows     (AtkTable *table);
gboolean    atk_table_is_column_selected    (AtkTable *table,
                                             gint column);
gboolean    atk_table_is_row_selected       (AtkTable *table,
                                             gint row);
gboolean    atk_table_is_selected           (AtkTable *table,
                                             gint row,
                                             gint column);
void        atk_table_set_caption           (AtkTable *table,
                                             gchar *caption);
void        atk_table_set_column_description
                                            (AtkTable *table,
                                             gint column,
                                             gchar *description);
void        atk_table_set_column_header     (AtkTable *table,
                                             gint column,
                                             AtkObject *header);
void        atk_table_set_row_description   (AtkTable *table,
                                             gint row,
                                             gchar *description);
void        atk_table_set_row_header        (AtkTable *table,
                                             gint row,
                                             AtkObject *header);
void        atk_table_set_summary           (AtkTable *table,
                                             AtkObject *accessible);

Description

AtkTable describes a user-interface component that presents data in two-dimensional table format.

Details

struct AtkTable

struct AtkTable;


struct AtkTableIface

struct AtkTableIface
{
  GTypeInterface parent;

  AtkObject*        (* ref_at)                   (AtkTable      *table,
                                                  gint          row,
                                                  gint          column);
  gint              (* get_index_at)             (AtkTable      *table,
                                                  gint          row,
                                                  gint          column);
  gint              (* get_column_at_index)      (AtkTable      *table,
                                                  gint          index);
  gint              (* get_row_at_index)         (AtkTable      *table,
                                                  gint          index);
  gint              (* get_n_columns)           (AtkTable      *table);
  gint              (* get_n_rows)               (AtkTable      *table);
  gint              (* get_column_extent_at)     (AtkTable      *table,
                                                  gint          row,
                                                  gint          column);
  gint              (* get_row_extent_at)        (AtkTable      *table,
                                                  gint          row,
                                                  gint          column);
  gchar*            (* get_caption)              (AtkTable      *table);
  gchar*            (* get_column_description)   (AtkTable      *table,
                                                  gint          column);
  AtkObject*        (* get_column_header)        (AtkTable      *table,
						  gint		column);
  gchar* 	    (* get_row_description)      (AtkTable      *table,
                                                  gint          row);
  AtkObject*        (* get_row_header)           (AtkTable      *table,
						  gint		row);
  AtkObject*        (* get_summary)              (AtkTable      *table);
  void              (* set_caption)              (AtkTable      *table,
                                                  gchar		*caption);
  void              (* set_column_description)   (AtkTable      *table,
                                                  gint          column,
                                                  gchar		*description);
  void              (* set_column_header)        (AtkTable      *table,
                                                  gint          column,
                                                  AtkObject     *header);
  void              (* set_row_description)      (AtkTable      *table,
                                                  gint          row,
                                                  gchar		*description);
  void              (* set_row_header)           (AtkTable      *table,
                                                  gint          row,
                                                  AtkObject     *header);
  void              (* set_summary)              (AtkTable      *table,
                                                  AtkObject     *accessible);
  gint*             (* get_selected_columns)     (AtkTable      *table);
  gint*             (* get_selected_rows)        (AtkTable      *table);
  gboolean          (* is_column_selected)       (AtkTable      *table,
                                                  gint          column);
  gboolean          (* is_row_selected)          (AtkTable      *table,
                                                  gint          row);
  gboolean          (* is_selected)              (AtkTable      *table,
                                                  gint          row,
                                                  gint          column);
  /*
   * signal handlers
   */
  void              (* model_changed)            (AtkTable      *table,
                                                  gint          type,
                                                  gint          first_row,
                                                  gint          last_row,
                                                  gint          first_column,
                                                  gint          last_column);
};


atk_table_ref_at ()

AtkObject*  atk_table_ref_at                (AtkTable *table,
                                             gint row,
                                             gint column);

Get a reference to the table cell at row, column

table : a GObject instance that implements AtkTableIface
row : a gint representing a row in table
column : a gint representing a column in table
Returns : a AtkObject* representing the referred to accessible


atk_table_get_index_at ()

gint        atk_table_get_index_at          (AtkTable *table,
                                             gint row,
                                             gint column);

Gets a gint representing the index at the specified row and column, or 0 if value does not implement this interface. Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
row : a gint representing a row in table
column : a gint representing a column in table
Returns : a gint representing the index at specified position, or 0 if value does not implement this interface.


atk_table_get_row_at_index ()

gint        atk_table_get_row_at_index      (AtkTable *table,
                                             gint index);

Gets a gint representing the row at the specified index, or 0 if the value does not implement this interface Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableInterface
index : a gint representing an index in table
Returns : a gint representing the row at the specified index, or 0 if value does not implement this interface.


atk_table_get_column_at_index ()

gint        atk_table_get_column_at_index   (AtkTable *table,
                                             gint index);

Gets a gint representing the column at the specified index, or 0 if the value does not implement this interface Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableInterface
index : a gint representing an index in table
Returns : a gint representing the column at the specified index, or 0 if value does not implement this interface.


atk_table_get_caption ()

gchar*      atk_table_get_caption           (AtkTable *table);

Gets the caption for the table. Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableInterface
Returns : a gchar* representing the table caption, or NULL if value does not implement this interface.


atk_table_get_n_columns ()

gint        atk_table_get_n_columns         (AtkTable *table);

Gets the number of columns in the table. Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
Returns : a gint representing the number of columns, or 0 if value does not implement this interface.


atk_table_get_column_description ()

gchar*      atk_table_get_column_description
                                            (AtkTable *table,
                                             gint column);

Gets the description text of the specified column in the table Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
column : a gint representing a column in table
Returns : a gchar* representing the column description, or NULL if value does not implement this interface.


atk_table_get_column_extent_at ()

gint        atk_table_get_column_extent_at  (AtkTable *table,
                                             gint row,
                                             gint column);

Gets the number of columns occupied by the accessible object at the specified row and column in the table. Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
row : a gint representing a row in table
column : a gint representing a column in table
Returns : a gint representing the column extent at specified position, or 0 if value does not implement this interface.


atk_table_get_column_header ()

AtkObject*  atk_table_get_column_header     (AtkTable *table,
                                             gint column);

Gets the column header of a specified column in an accessible table. Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
column : a gint representing a column in the table
Returns : a AtkObject* representing the specified column header, or NULL if value does not implement this interface.


atk_table_get_n_rows ()

gint        atk_table_get_n_rows            (AtkTable *table);

Gets the number of rows in the table. Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
Returns : a gint representing the number of rows, or 0 if value does not implement this interface.


atk_table_get_row_description ()

gchar*      atk_table_get_row_description   (AtkTable *table,
                                             gint r);

Gets the description text of the specified row in the table Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
r : a gint representing a row in table
Returns : a gchar* representing the row description, or NULL if value does not implement this interface.


atk_table_get_row_extent_at ()

gint        atk_table_get_row_extent_at     (AtkTable *table,
                                             gint row,
                                             gint column);

Gets the number of rows occupied by the accessible object at a specified row and column in the table. Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
row : a gint representing a row in table
column : a gint representing a column in table
Returns : a gint representing the row extent at specified position, or 0 if value does not implement this interface.


atk_table_get_row_header ()

AtkObject*  atk_table_get_row_header        (AtkTable *table,
                                             gint row);

Gets the row header of a specified row in an accessible table. Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
row : a gint representing a row in the table
Returns : a AtkObject* representing the specified row header, or NULL if value does not implement this interface.


atk_table_get_summary ()

AtkObject*  atk_table_get_summary           (AtkTable *table);

Gets the summary description of the table. Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
Returns : a AtkObject* representing a sumary description of the table, or NULL if value does not implement this interface.


atk_table_get_selected_columns ()

gint*       atk_table_get_selected_columns  (AtkTable *table);

Gets the selected columns of the table. Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
Returns : a gint* representing the selected columns, or NULL if value does not implement this interface.


atk_table_get_selected_rows ()

gint*       atk_table_get_selected_rows     (AtkTable *table);

Gets the selected rows of the table. Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
Returns : a gint* representing the selected rows, or NULL if value does not implement this interface.


atk_table_is_column_selected ()

gboolean    atk_table_is_column_selected    (AtkTable *table,
                                             gint column);

Gets a boolean value indicating whether the specified column is selected Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
column : a gint representing a column in table
Returns : a gboolean representing if the column is selected, or 0 if value does not implement this interface.


atk_table_is_row_selected ()

gboolean    atk_table_is_row_selected       (AtkTable *table,
                                             gint row);

Gets a boolean value indicating whether the specified row is selected Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
row : a gint representing a row in table
Returns : a gboolean representing if the row is selected, or 0 if value does not implement this interface.


atk_table_is_selected ()

gboolean    atk_table_is_selected           (AtkTable *table,
                                             gint row,
                                             gint column);

Gets a boolean value indicating whether the acessible object at the specified row and column is selected Note: callers should not rely on NULL or on a zero value for indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_table() convenience method.

table : a GObject instance that implements AtkTableIface
row : a gint representing a row in table
column : a gint representing a column in table
Returns : a gboolean representing if the cell is selected, or 0 if value does not implement this interface.


atk_table_set_caption ()

void        atk_table_set_caption           (AtkTable *table,
                                             gchar *caption);

Sets the caption for the table.

table : a GObject instance that implements AtkTableIface
caption : a gchar representing the caption to set for table


atk_table_set_column_description ()

void        atk_table_set_column_description
                                            (AtkTable *table,
                                             gint column,
                                             gchar *description);

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

table : a GObject instance that implements AtkTableIface
column : a gint representing a column in table
description : a gchar representing the description text to set for the specified column of the table


atk_table_set_column_header ()

void        atk_table_set_column_header     (AtkTable *table,
                                             gint column,
                                             AtkObject *header);

Sets the specified column header to header

table : a GObject instance that implements AtkTableIface
column : a gint representing a column in table
header : an AtkTable


atk_table_set_row_description ()

void        atk_table_set_row_description   (AtkTable *table,
                                             gint row,
                                             gchar *description);

Sets the description text for the specified row of table.

table : a GObject instance that implements AtkTableIface
row : a gint representing a row in table
description : a gchar representing the description text to set for the specified row of table


atk_table_set_row_header ()

void        atk_table_set_row_header        (AtkTable *table,
                                             gint row,
                                             AtkObject *header);

Sets the specified row header to header

table : a GObject instance that implements AtkTableIface
row : a gint representing a row in table
header : an AtkTable


atk_table_set_summary ()

void        atk_table_set_summary           (AtkTable *table,
                                             AtkObject *accessible);

Sets the summary description of the table

table : a GObject instance that implements AtkTableIface
accessible : an AtkObject representing the summary description to set for table