Mon Jun 2 15:35:29 2003 Jonathan Blandford <jrb@redhat.com>
[platform/core/uifw/at-spi2-atk.git] / cspi / spi_table.c
index ff8754a..00421e8 100644 (file)
-int
-SpiAccessibleTable_ref (SpiAccessibleTable *obj)
+/*
+ * AT-SPI - Assistive Technology Service Provider Interface
+ * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap)
+ *
+ * Copyright 2001, 2002 Sun Microsystems Inc.,
+ * Copyright 2001, 2002 Ximian, Inc.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+#include <stdlib.h> /* for malloc */
+#include <cspi/spi-private.h>
+
+/**
+ * AccessibleTable_ref:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ *
+ * Increment the reference count for an #AccessibleTable object.
+ **/
+void
+AccessibleTable_ref (AccessibleTable *obj)
 {
-  Accessibility_Table_ref (*obj, &ev);
-  return 0;
+  cspi_object_ref (obj);
 }
 
-
-
-int
-SpiAccessibleTable_unref (SpiAccessibleTable *obj)
+/**
+ * AccessibleTable_unref:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ *
+ * Decrement the reference count for an #AccessibleTable object.
+ **/
+void
+AccessibleTable_unref (AccessibleTable *obj)
 {
-  Accessibility_Table_unref (*obj, &ev);
-  return 0;
+  cspi_object_unref (obj);
 }
 
-
-
-SpiAccessible *
-SpiAccessibleTable_getCaption (SpiAccessibleTable *obj)
+/**
+ * AccessibleTable_getCaption:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ *
+ * Get an accessible representation of the caption for an #AccessibleTable.
+ *
+ * Returns: an #Accessible object that serves as the table's caption.
+ **/
+Accessible *
+AccessibleTable_getCaption (AccessibleTable *obj)
 {
-  return (SpiAccessible *)
-    Accessibility_Table__get_caption (*obj, &ev);
-}
+  Accessible *retval;
 
+  cspi_return_val_if_fail (obj != NULL, NULL);
 
+  retval =  cspi_object_add (
+                            Accessibility_Table__get_caption (CSPI_OBJREF (obj), cspi_ev ()));
+  cspi_return_val_if_ev ("getCaption", NULL);
+  return retval;
+}
 
-SpiAccessible *
-SpiAccessibleTable_getSummary (SpiAccessibleTable *obj)
+/**
+ * AccessibleTable_getSummary:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ *
+ * Get an accessible object which summarizes the contents of an #AccessibleTable.
+ *
+ * Returns: an #Accessible object that serves as the table's summary (often a
+ *          reduced #AccessibleTable).
+ **/
+Accessible *
+AccessibleTable_getSummary (AccessibleTable *obj)
 {
-  return (SpiAccessible *)
-    Accessibility_Table__get_summary (*obj, &ev);
-}
+  Accessible *retval;
 
+  cspi_return_val_if_fail (obj != NULL, NULL);
 
+retval = cspi_object_add (
+                         Accessibility_Table__get_summary (CSPI_OBJREF (obj), cspi_ev ()));
+ cspi_return_val_if_ev ("getSummary", NULL);
+ return retval;
+}
 
+/**
+ * AccessibleTable_getNRows:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ *
+ * Get the number of rows in an #AccessibleTable,
+ *        exclusive of any rows that are programmatically hidden, but inclusive
+ *        of rows that may be outside of the current scrolling window or viewport.
+ *
+ * Returns: a #long integer indicating the number of rows in the table.
+ **/
 long
-SpiAccessibleTable_getNRows (SpiAccessibleTable *obj)
+AccessibleTable_getNRows (AccessibleTable *obj)
 {
-  return (long)
-    Accessibility_Table__get_nRows (*obj, &ev);
-}
+  long retval;
+
+  cspi_return_val_if_fail (obj != NULL, -1);
 
+  retval =
+    Accessibility_Table__get_nRows (CSPI_OBJREF (obj), cspi_ev ());
+         
+  cspi_return_val_if_ev ("getNRows", -1);
 
+  return retval;
+         
+}
 
+/**
+ * AccessibleTable_getNColumns:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ *
+ * Get the number of columns in an #AccessibleTable,
+ *        exclusive of any columns that are programmatically hidden, but inclusive
+ *        of columns that may be outside of the current scrolling window or viewport.
+ *
+ * Returns: a #long integer indicating the number of columns in the table.
+ **/
 long
-SpiAccessibleTable_getNColumns (SpiAccessibleTable *obj)
+AccessibleTable_getNColumns (AccessibleTable *obj)
 {
-  return (long)
-    Accessibility_Table__get_nColumns (*obj, &ev);
-}
+  long retval;
 
+  cspi_return_val_if_fail (obj != NULL, -1);
 
-SpiAccessible *
-SpiAccessibleTable_getAccessibleAt (SpiAccessibleTable *obj,
-                                 long row,
-                                 long column)
-{
-  return (SpiAccessible *)
-    Accessibility_Table_getAccessibleAt (*obj,
-                              (CORBA_long) row, (CORBA_long) column, &ev);
+  retval =
+    Accessibility_Table__get_nColumns (CSPI_OBJREF (obj), cspi_ev ());
+         
+  cspi_return_val_if_ev ("getNColumns", -1);
+
+  return retval;
 }
 
+/**
+ * AccessibleTable_getAccessibleAt:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @row: the specified table row, zero-indexed.
+ * @column: the specified table column, zero-indexed.
+ *
+ * Get the table cell at the specified row and column indices.
+ *          To get the accessible object at a particular (x, y) screen coordinate,
+ *          use #Accessible_getAccessibleAtPoint ().
+ *
+ * Returns: an #Accessible object representing the specified table cell.
+ **/
+Accessible *
+AccessibleTable_getAccessibleAt (AccessibleTable *obj,
+                                 long int row,
+                                 long int column)
+{
+  Accessible *retval;
+
+  cspi_return_val_if_fail (obj != NULL, NULL);
 
+  retval = cspi_object_add (
+                           Accessibility_Table_getAccessibleAt (
+                                                                CSPI_OBJREF (obj), row,
+                                                                column, cspi_ev ()));
+  cspi_return_val_if_ev ("getAccessibleAt", NULL);
+ return retval;
+}
+
+/**
+ * AccessibleTable_getIndexAt:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @row: the specified table row, zero-indexed.
+ * @column: the specified table column, zero-indexed.
+ *
+ * Get the 1-D child index corresponding to the specified 2-D row and column indices.
+ *          To get the accessible object at a particular (x, y) screen coordinate,
+ *          use #Accessible_getAccessibleAtPoint ().
+ * @see #AccessibleTable_getRowAtIndex(), #AccessibleTable_getColumnAtIndex()
+ *
+ * Returns: a long integer which serves as the index of a specified cell in the
+ *          table, in a form usable by #Accessible_getChildAtIndex().
+ **/
 long
-SpiAccessibleTable_getIndexAt (SpiAccessibleTable *obj,
-                            long row,
-                            long column)
+AccessibleTable_getIndexAt (AccessibleTable *obj,
+                            long int row,
+                            long int column)
 {
-  return (long)
-    Accessibility_Table_getIndexAt (*obj,
-                                   (CORBA_long) row, (CORBA_long) column, &ev);
-}
+  long retval;
 
+  cspi_return_val_if_fail (obj != NULL, -1);
 
+  retval =
+    Accessibility_Table_getIndexAt (
+      CSPI_OBJREF (obj), row,
+      column, cspi_ev ());
+         
+  cspi_return_val_if_ev ("getIndexAt", -1);
 
+  return retval;
+}
+
+/**
+ * AccessibleTable_getRowAtIndex:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @index: the specified child index, zero-indexed.
+ *
+ * Get the table row index occupied by the child at a particular 1-D child index.
+ *
+ * @see #AccessibleTable_getIndexAt(), #AccessibleTable_getColumnAtIndex()
+ *
+ * Returns: a long integer indicating the first row spanned by the child of a
+ *          table, at the specified 1-D (zero-offset) @index.
+ **/
 long
-SpiAccessibleTable_getRowAtIndex (SpiAccessibleTable *obj,
+AccessibleTable_getRowAtIndex (AccessibleTable *obj,
                                long index)
 {
-  return (long)
-    Accessibility_Table_getRowAtIndex (*obj,
-                                      (CORBA_long) index, &ev);
-}
+  long retval;
 
+  cspi_return_val_if_fail (obj != NULL, -1);
 
+  retval =
+    Accessibility_Table_getRowAtIndex (CSPI_OBJREF (obj),
+                                      index, cspi_ev ());
+         
+  cspi_return_val_if_ev ("getRowAtIndex", -1);
 
+  return retval;
+}
+
+/**
+ * AccessibleTable_getColumnAtIndex:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @index: the specified child index, zero-indexed.
+ *
+ * Get the table column index occupied by the child at a particular 1-D child index.
+ *
+ * @see #AccessibleTable_getIndexAt(), #AccessibleTable_getRowAtIndex()
+ *
+ * Returns: a long integer indicating the first column spanned by the child of a
+ *          table, at the specified 1-D (zero-offset) @index.
+ **/
 long
-SpiAccessibleTable_getColumnAtIndex (SpiAccessibleTable *obj,
+AccessibleTable_getColumnAtIndex (AccessibleTable *obj,
                                   long index)
 {
-  return (long)
-    Accessibility_Table_getColumnAtIndex (*obj,
-                                         (CORBA_long) index, &ev);
-}
+  long retval;
 
+  cspi_return_val_if_fail (obj != NULL, -1);
 
+  retval =
+    Accessibility_Table_getColumnAtIndex (CSPI_OBJREF (obj),
+                                         index, cspi_ev ());
+         
+  cspi_return_val_if_ev ("getColumnAtIndex", -1);
 
+  return retval;
+}
+
+/**
+ * AccessibleTable_getRowDescription:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @row: the specified table row, zero-indexed.
+ *
+ * Get a text description of a particular table row.  This differs from
+ * AccessibleTable_getRowHeader, which returns an #Accessible.
+ *
+ * Returns: a UTF-8 string describing the specified table row, if available.
+ **/
 char *
-SpiAccessibleTable_getRowDescription (SpiAccessibleTable *obj,
-                                  long row)
+AccessibleTable_getRowDescription (AccessibleTable *obj,
+                                  long int         row)
 {
-  return (char *)
-    Accessibility_Table_getRowDescription (*obj,
-                                          (CORBA_long) row, &ev);
-}
+  char *retval;
 
+  cspi_return_val_if_fail (obj != NULL, NULL);
 
+  retval =
+    Accessibility_Table_getRowDescription (CSPI_OBJREF (obj),
+                                          row, cspi_ev ());
+         
+  cspi_return_val_if_ev ("getRowDescription", NULL);
 
+  return retval;
+}
+
+/**
+ * AccessibleTable_getColumnDescription:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @column: the specified table column, zero-indexed.
+ *
+ * Get a text description of a particular table column.  This differs from
+ * AccessibleTable_getColumnHeader, which returns an #Accessible.
+ *
+ * Returns: a UTF-8 string describing the specified table column, if available.
+ **/
 char *
-SpiAccessibleTable_getColumnDescription (SpiAccessibleTable *obj,
-                                     long column)
+AccessibleTable_getColumnDescription (AccessibleTable *obj,
+                                     long int         column)
 {
-  return (char *)
-    Accessibility_Table_getColumnDescription (*obj,
-                                             (CORBA_long) column, &ev);
-}
+  char *retval;
 
+  cspi_return_val_if_fail (obj != NULL, NULL);
 
+  retval =
+    Accessibility_Table_getColumnDescription (CSPI_OBJREF (obj),
+                                             column, cspi_ev ());
 
+  cspi_return_val_if_ev ("getColumnDescription", NULL);
+
+  return retval;
+}
+
+/**
+ * AccessibleTable_getRowExtentAt:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @row: the specified table row, zero-indexed.
+ * @column: the specified table column, zero-indexed.
+ *
+ * Get the number of rows spanned by the table cell at the specific row and column.
+ * (some tables can have cells which span multiple rows and/or columns).
+ *
+ * Returns: a long integer indicating the number of rows spanned by the specified cell.
+ **/
 long
-SpiAccessibleTable_getRowExtentAt (SpiAccessibleTable *obj,
-                                long row,
-                                long column)
+AccessibleTable_getRowExtentAt (AccessibleTable *obj,
+                                long int         row,
+                                long int         column)
 {
-  return (long)
-    Accessibility_Table_getRowExtentAt (*obj,
-                                       (CORBA_long) row, (CORBA_long) column, &ev);
-}
+  long retval;
+
+  cspi_return_val_if_fail (obj != NULL, -1);
 
+  retval =
+    Accessibility_Table_getRowExtentAt (
+      CSPI_OBJREF (obj), row,
+      column, cspi_ev ());
+         
+  cspi_return_val_if_ev ("getRowExtentAt", -1);
 
+  return retval;
+}
 
+/**
+ * AccessibleTable_getColumnExtentAt:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @row: the specified table row, zero-indexed.
+ * @column: the specified table column, zero-indexed.
+ *
+ * Get the number of columns spanned by the table cell at the specific row and column.
+ * (some tables can have cells which span multiple rows and/or columns).
+ *
+ * Returns: a long integer indicating the number of columns spanned by the specified cell.
+ **/
 long
-SpiAccessibleTable_getColumnExtentAt (SpiAccessibleTable *obj,
-                                   long row,
-                                   long column)
+AccessibleTable_getColumnExtentAt (AccessibleTable *obj,
+                                   long int         row,
+                                   long int         column)
 {
-  return (long)
-    Accessibility_Table_getColumnExtentAt (*obj,
-                                       (CORBA_long) row, (CORBA_long) column, &ev);
-}
+  long retval;
 
+  cspi_return_val_if_fail (obj != NULL, -1);
 
+  retval =
+    Accessibility_Table_getColumnExtentAt (
+      CSPI_OBJREF (obj), row,
+      column, cspi_ev ());
+         
+  cspi_return_val_if_ev ("getColumnExtentAt", -1);
 
-SpiAccessible *
-SpiAccessibleTable_getRowHeader (SpiAccessibleTable *obj,
-                             long row)
-{
-  return (SpiAccessible *)
-    Accessibility_Table_getRowHeader (*obj,
-                                     (CORBA_long) row, &ev);
+  return retval;
 }
 
+/**
+ * AccessibleTable_getRowHeader:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @row: the specified table row, zero-indexed.
+ *
+ * Get the header associated with a table row, if available.  This differs from
+ * AccessibleTable_getRowDescription, which returns a string.
+ *
+ * Returns: a #Accessible representatin of the specified table row, if available.
+ **/
+Accessible *
+AccessibleTable_getRowHeader (AccessibleTable *obj,
+                             long int         row)
+{
+  Accessible *retval;
+
+  cspi_return_val_if_fail (obj != NULL, NULL);
 
+  retval = cspi_object_add (
+                           Accessibility_Table_getRowHeader (CSPI_OBJREF (obj),
+                                                             row, cspi_ev ()));
+  cspi_return_val_if_ev ("getRowHeader", NULL);
 
-SpiAccessible *
-SpiAccessibleTable_getColumnHeader (SpiAccessibleTable *obj,
-                                long column)
-{
-  return (SpiAccessible *)
-    Accessibility_Table_getColumnHeader (*obj,
-                                     (CORBA_long) column, &ev);
+ return retval;
 }
 
+/**
+ * AccessibleTable_getColumnHeader:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @column: the specified table column, zero-indexed.
+ *
+ * Get the header associated with a table column, if available.  This differs from
+ * AccessibleTable_getColumnDescription, which returns a string.
+ *
+ * Returns: a #Accessible representatin of the specified table column, if available.
+ **/
+Accessible *
+AccessibleTable_getColumnHeader (AccessibleTable *obj,
+                                long int column)
+{
+  Accessible *retval;
+
+  cspi_return_val_if_fail (obj != NULL, NULL);
+
+  retval = cspi_object_add (
+                           Accessibility_Table_getColumnHeader (CSPI_OBJREF (obj),
+                                                                column, cspi_ev ()));
+  cspi_return_val_if_ev ("getColumnHeader", NULL);
 
+  return retval;
+}
 
+/**
+ * AccessibleTable_getNSelectedRows:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ *
+ * Query a table to find out how many rows are currently selected.  Not all tables
+ *  support row selection.
+ *
+ * Returns: a long integer indicating the number of rows currently selected.
+ **/
 long
-SpiAccessibleTable_getNSelectedRows (SpiAccessibleTable *obj)
+AccessibleTable_getNSelectedRows (AccessibleTable *obj)
 {
-  return (long)
-    Accessibility_Table__get_nSelectedRows (*obj, &ev);
-}
+  long retval;
 
+  cspi_return_val_if_fail (obj != NULL, -1);
 
+  retval =
+    Accessibility_Table__get_nSelectedRows (CSPI_OBJREF (obj), cspi_ev ());
+         
+  cspi_return_val_if_ev ("getNSelectedRows", -1);
 
-long
-SpiAccessibleTable_getSelectedRows (SpiAccessibleTable *obj,
-                                 long **selectedRows)
+  return retval;
+}
+
+static long
+cspi_long_seq_to_array (Accessibility_LongSeq *seq, long int **array)
 {
-  Accessibility_LongSeq *rows = Accessibility_Table_getSelectedRows (*obj, &ev);
-  CORBA_long *i;
   long *j;
-  long length;
+  long length, i;
+
+  if (!cspi_check_ev ("getSelectionItems"))
+    {
+      *array = NULL;
+      return 0;
+    }
+
+  length = seq->_length;
+
+  j = *array = malloc (sizeof (long) * length);
 
-  i = rows->_buffer;
-  length = (long) rows->_length;
-  j = *selectedRows = (long *) malloc (sizeof(long)*length);
-  
-  while (length--)
-    *j++ = (CORBA_long) (*i++);
+  for (i = 0; i < length; i++)
+    {
+      j[i] = seq->_buffer [i];
+    }
+
+  CORBA_free (seq);
 
-  length = rows->_length;
-  CORBA_free (rows);
   return length;
 }
 
+/**
+ * AccessibleTable_getSelectedRows:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @selectedRows: a doubly indirected pointer which will be set to the address
+ *       of an array of long integers, specifying which rows are currently selected.
+ *
+ * Query a table for a list of indices of rows which are currently selected.
+ *
+ * Returns: a long integer indicating the length of the array returned in @selectedRows.
+ **/
+long
+AccessibleTable_getSelectedRows (AccessibleTable *obj,
+                                 long int       **selectedRows)
+{
+  Accessibility_LongSeq *rows;
 
+  *selectedRows = NULL;
 
+  cspi_return_val_if_fail (obj != NULL, 0);
+
+  rows = Accessibility_Table_getSelectedRows (CSPI_OBJREF (obj), cspi_ev ());
+
+  cspi_return_val_if_ev ("getSelectedRows", -1);
+
+  return cspi_long_seq_to_array (rows, selectedRows);
+}
+
+/**
+ * AccessibleTable_getNSelectedColumns:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ *
+ * Query a table to find out how many columns are currently selected.  Not all tables
+ *  support column selection.
+ *
+ * Returns: a long integer indicating the number of columns currently selected.
+ **/
 long
-SpiAccessibleTable_getNSelectedColumns (SpiAccessibleTable *obj)
+AccessibleTable_getNSelectedColumns (AccessibleTable *obj)
 {
-  return (long)
-    Accessibility_Table__get_nSelectedColumns (*obj, &ev);
-}
+  long retval;
 
+  cspi_return_val_if_fail (obj != NULL, -1);
 
+  retval =
+    Accessibility_Table__get_nSelectedColumns (CSPI_OBJREF (obj), cspi_ev ());
+         
+  cspi_return_val_if_ev ("getNSelectedColumns", -1);
+
+  return retval;
+}
+
+/**
+ * AccessibleTable_getSelectedColumns:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @selectedColumns: a doubly indirected pointer which will be set to the address
+ *       of an array of long integers, specifying which columns are currently selected.
+ *
+ * Query a table for a list of indices of columns which are currently selected.
+ *       Not all tables support column selection.
+ *
+ * Returns: a long integer indicating the length of the array returned in @selectedColumns.
+ **/
 long
-SpiAccessibleTable_getSelectedColumns (SpiAccessibleTable *obj,
-                                    long **selectedColumns)
+AccessibleTable_getSelectedColumns (AccessibleTable *obj,
+                                    long int       **selectedColumns)
 {
-  Accessibility_LongSeq *columns = Accessibility_Table_getSelectedColumns (*obj, &ev);
-  CORBA_long *i;
-  long *j;
-  long length;
+  Accessibility_LongSeq *columns;
 
-  i = columns->_buffer;
-  length = (long) columns->_length;
-  j = *selectedColumns = (long *) malloc (sizeof(long)*length);
-  
-  while (length--)
-    *j++ = (CORBA_long) (*i++);
+  *selectedColumns = NULL;
 
-  length = columns->_length;
-  CORBA_free (columns);
-  return length;
+  cspi_return_val_if_fail (obj != NULL, 0);
+
+  columns = Accessibility_Table_getSelectedColumns (CSPI_OBJREF (obj), cspi_ev ());
+
+  cspi_return_val_if_ev ("getSelectedColumns", -1);
+  return cspi_long_seq_to_array (columns, selectedColumns);
 }
 
+/**
+ * AccessibleTable_isRowSelected:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @row:
+ *
+ * Determine whether a table row is selected.  Not all tables support row selection.
+ *
+ * Returns: #TRUE if the specified row is currently selected, #FALSE if not.
+ **/
+SPIBoolean
+AccessibleTable_isRowSelected (AccessibleTable *obj,
+                               long int         row)
+{
+  SPIBoolean retval;
+
+  cspi_return_val_if_fail (obj != NULL, FALSE);
 
-boolean
-SpiAccessibleTable_isRowSelected (SpiAccessibleTable *obj,
-                               long row)
+  retval =
+    Accessibility_Table_isRowSelected (CSPI_OBJREF (obj),
+                                      row, cspi_ev ());
+
+  cspi_return_val_if_ev ("isRowSelected", FALSE);
+
+  return retval;
+}
+
+/**
+ * AccessibleTable_isColumnSelected:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @column:
+ *
+ * Determine whether specified table column is selected.
+ * Not all tables support column selection.
+ *
+ * Returns: #TRUE if the specified column is currently selected, #FALSE if not.
+ **/
+SPIBoolean
+AccessibleTable_isColumnSelected (AccessibleTable *obj,
+                                  long int         column)
+{
+  SPIBoolean retval;
+
+  cspi_return_val_if_fail (obj != NULL, FALSE);
+
+  retval =
+    Accessibility_Table_isColumnSelected (CSPI_OBJREF (obj),
+                                         column, cspi_ev ());
+         
+  cspi_return_val_if_ev ("isColumnSelected", FALSE);
+
+  return retval;
+}
+
+/**
+ * AccessibleTable_addRowSelection:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @row:
+ *
+ * Select the specified row, adding it to the current row selection.
+ * Not all tables support row selection.
+ *
+ * Returns: #TRUE if the specified row was successfully selected, #FALSE if not.
+ **/
+SPIBoolean
+AccessibleTable_addRowSelection (AccessibleTable *obj,
+                                long int         row)
 {
-  return (boolean)
-    Accessibility_Table_isRowSelected (*obj,
-                                      (CORBA_long) row, &ev);
+  SPIBoolean retval;
+
+  cspi_return_val_if_fail (obj != NULL, FALSE);
+
+  retval =
+    Accessibility_Table_addRowSelection (CSPI_OBJREF (obj),
+                                        row, cspi_ev ());
+         
+  cspi_return_val_if_ev ("addRowSelection", FALSE);
+
+  return retval;
 }
 
+/**
+ * AccessibleTable_addColumnSelection:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @column:
+ *
+ * Select the specified column, adding it to the current column selection.
+ * Not all tables support column selection.
+ *
+ * Returns: #TRUE if the specified column was successfully selected, #FALSE if not.
+ **/
+SPIBoolean
+AccessibleTable_addColumnSelection (AccessibleTable *obj,
+                                   long int         column)
+{
+  SPIBoolean retval;
+
+  cspi_return_val_if_fail (obj != NULL, FALSE);
 
+  retval =
+    Accessibility_Table_addColumnSelection (CSPI_OBJREF (obj),
+                                           column, cspi_ev ());
+         
+  cspi_return_val_if_ev ("addColumnSelection", FALSE);
 
-boolean
-SpiAccessibleTable_isColumnSelected (SpiAccessibleTable *obj,
-                                  long column)
+  return retval;
+}
+
+/**
+ * AccessibleTable_removeRowSelection:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @row:
+ *
+ * De-select the specified row, removing it to the current row selection.
+ * Not all tables support row selection.
+ *
+ * Returns: #TRUE if the specified row was successfully de-selected, #FALSE if not.
+ **/
+SPIBoolean
+AccessibleTable_removeRowSelection (AccessibleTable *obj,
+                                   long int         row)
 {
-  return (boolean)
-    Accessibility_Table_isColumnSelected (*obj,
-                                      (CORBA_long) column, &ev);
+  SPIBoolean retval;
+
+  cspi_return_val_if_fail (obj != NULL, FALSE);
+
+  retval =
+    Accessibility_Table_removeRowSelection (CSPI_OBJREF (obj),
+                                           row, cspi_ev ());
+         
+  cspi_return_val_if_ev ("removeRowSelection", FALSE);
+
+  return retval;
 }
 
+/**
+ * AccessibleTable_removeColumnSelection:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @column:
+ *
+ * De-select the specified column, removing it to the current column selection.
+ * Not all tables support column selection.
+ *
+ * Returns: #TRUE if the specified column was successfully de-selected, #FALSE if not.
+ **/
+SPIBoolean
+AccessibleTable_removeColumnSelection (AccessibleTable *obj,
+                                      long int         column)
+{
+  SPIBoolean retval;
+
+  cspi_return_val_if_fail (obj != NULL, FALSE);
+
+  retval =
+    Accessibility_Table_removeColumnSelection (CSPI_OBJREF (obj),
+                                              column, cspi_ev ());
+         
+  cspi_return_val_if_ev ("removeColumnSelection", FALSE);
 
+  return retval;
+}
 
-boolean
-SpiAccessibleTable_isSelected (SpiAccessibleTable *obj,
-                            long row,
-                            long column)
+/**
+ * AccessibleTable_isSelected:
+ * @obj: a pointer to the #AccessibleTable implementor on which to operate.
+ * @row:
+ * @column:
+ *
+ * Determine whether the cell at a specific row and column is selected.
+ *
+ * Returns: #TRUE if the specified cell is currently selected, #FALSE if not.
+ **/
+SPIBoolean
+AccessibleTable_isSelected (AccessibleTable *obj,
+                            long int row,
+                            long int column)
 {
-return (boolean)
-  Accessibility_Table_isSelected (*obj,
-                                 (CORBA_long) row, (CORBA_long) column, &ev);
+  SPIBoolean retval;
+
+  cspi_return_val_if_fail (obj != NULL, FALSE);
+
+  retval =
+    Accessibility_Table_isSelected (CSPI_OBJREF (obj),
+                                   row,
+                                   column, cspi_ev ());
+         
+  cspi_return_val_if_ev ("isSelected", FALSE);
+
+  return retval;
 }