1 /* ATK - Accessibility Toolkit
2 * Copyright 2001 Sun Microsystems Inc.
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
20 #ifndef __ATK_TABLE_H__
21 #define __ATK_TABLE_H__
23 #include <atk/atkobject.h>
27 #endif /* __cplusplus */
30 * AtkTable describes a user-interface component that presents data in
31 * two-dimensional table format.
35 #define ATK_TYPE_TABLE (atk_table_get_type ())
36 #define ATK_IS_TABLE(obj) G_TYPE_CHECK_INSTANCE_TYPE ((obj), ATK_TYPE_TABLE)
37 #define ATK_TABLE(obj) G_TYPE_CHECK_INSTANCE_CAST ((obj), ATK_TYPE_TABLE, AtkTable)
38 #define ATK_TABLE_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), ATK_TYPE_TABLE, AtkTableIface))
40 #ifndef _TYPEDEF_ATK_TABLE_
41 #define _TYPEDEF_ATK_TABLE_
42 typedef struct _AtkTable AtkTable;
47 GTypeInterface parent;
50 * Returns a reference to the accessible object at a specified row
51 * and column in the table.
53 AtkObject* (* ref_at) (AtkTable *table,
56 gint (* get_index_at) (AtkTable *table,
59 gint (* get_row_at_index) (AtkTable *table,
61 gint (* get_column_at_index) (AtkTable *table,
64 * Returns the caption for the table.
66 AtkObject* (* get_caption) (AtkTable *table);
68 * Returns the number of columns in the table.
70 gint (* get_n_columns) (AtkTable *table);
72 * Returns the description text of the specified column in the table
74 AtkObject* (* get_column_description) (AtkTable *table,
77 * Returns the number of columns occupied by the accessible object
78 * at a specified row and column in the table.
80 gint (* get_column_extent_at) (AtkTable *table,
84 * Returns the column headers of an accessible table.
86 AtkTable* (* get_column_header) (AtkTable *table);
88 * Returns the number of rows in the table.
90 gint (* get_n_rows) (AtkTable *table);
92 * Returns the description text of the specified row in the table
94 AtkObject* (* get_row_description) (AtkTable *table,
97 * Returns the number of rows occupied by the accessible object
98 * at a specified row and column in the table.
100 gint (* get_row_extent_at) (AtkTable *table,
104 * Returns the row headers of an accessible table.
106 AtkTable* (* get_row_header) (AtkTable *table);
108 * Returns the summary description of the table.
110 AtkObject* (* get_summary) (AtkTable *table);
112 * Returns the selected columns of the table.
114 gint* (* get_selected_columns) (AtkTable *table);
116 * Returns the selected rows of the table.
118 gint* (* get_selected_rows) (AtkTable *table);
120 * Returns a boolean value indicating whether the specified column
123 gboolean (* is_column_selected) (AtkTable *table,
126 * Returns a boolean value indicating whether the specified row
129 gboolean (* is_row_selected) (AtkTable *table,
132 * Returns a boolean value indicating whether the acessible object
133 * at the specified row and column is selected
135 gboolean (* is_selected) (AtkTable *table,
139 * Sets the caption for the table.
141 void (* set_caption) (AtkTable *table,
142 AtkObject *accessible);
144 * Sets the description text for the specified column of the table.
146 void (* set_column_description) (AtkTable *table,
148 AtkObject *accessible);
150 * Sets the column headers
152 void (* set_column_header) (AtkTable *table,
156 * Sets the description text for the specified row of the table.
158 void (* set_row_description) (AtkTable *table,
160 AtkObject *accessible);
162 * Sets the row headers
164 void (* set_row_header) (AtkTable *table,
168 * Sets the summary description of the table
170 void (* set_summary) (AtkTable *table,
171 AtkObject *accessible);
174 GType atk_table_get_type ();
176 AtkObject* atk_table_ref_at (AtkTable *table,
179 gint atk_table_get_index_at (AtkTable *table,
182 gint atk_table_get_row_at_index (AtkTable *table,
184 gint atk_table_get_column_at_index (AtkTable *table,
186 AtkObject* atk_table_get_caption (AtkTable *table);
187 gint atk_table_get_n_columns (AtkTable *table);
188 AtkObject* atk_table_get_column_description (AtkTable *table,
190 gint atk_table_get_column_extent_at (AtkTable *table,
193 AtkTable* atk_table_get_column_header (AtkTable *table);
194 gint atk_table_get_n_rows (AtkTable *table);
195 AtkObject* atk_table_get_row_description (AtkTable *table,
197 gint atk_table_get_row_extent_at (AtkTable *table,
200 AtkTable* atk_table_get_row_header (AtkTable *table);
201 AtkObject* atk_table_get_summary (AtkTable *table);
202 gint* atk_table_get_selected_columns (AtkTable *table);
203 gint* atk_table_get_selected_rows (AtkTable *table);
204 gboolean atk_table_is_column_selected (AtkTable *table,
206 gboolean atk_table_is_row_selected (AtkTable *table,
208 gboolean atk_table_is_selected (AtkTable *table,
211 void atk_table_set_caption (AtkTable *table,
212 AtkObject *accessible);
213 void atk_table_set_column_description (AtkTable *table,
215 AtkObject *accessible);
216 void atk_table_set_column_header (AtkTable *table,
219 void atk_table_set_row_description (AtkTable *table,
221 AtkObject *accessible);
222 void atk_table_set_row_header (AtkTable *table,
225 void atk_table_set_summary (AtkTable *table,
226 AtkObject *accessible);
230 #endif /* __cplusplus */
233 #endif /* __ATK_TABLE_H__ */