2009-06-11 Mark Doffman <mark.doffman@codethink.co.uk>
[platform/core/uifw/at-spi2-atk.git] / idl / Accessibility_Selection.idl
index e059ed9..aa4180b 100644 (file)
@@ -127,6 +127,27 @@ module Accessibility {
      */
     boolean clearSelection ();
     /**
+     * Remove a child from the selected children list of a Selection,
+     *       if the child is currently selected.
+     *
+     * @note unlike deselectSelectedChild, \c childIndex is the zero-offset
+     *       index into the Accessible instance's list of children,
+     *       not the index into the 'selected child list'.
+     *
+     * @param childIndex: a long integer (the zero offset index into the Accessible
+     *              object's list of children) indicating which child of the
+     *              Selection is to be selected.
+     *
+     * @returns \c True if the child was successfully selected, 
+     *          \c False otherwise.
+     *
+     * @see deselectSelectedChild
+     *
+     * @since AT-SPI 1.8.0
+     */
+    boolean deselectChild (in long childIndex);
+
+    /**
      * unImplemented:
      *
      * placeholders for future expansion.
@@ -134,6 +155,5 @@ module Accessibility {
     void unImplemented ();
     void unImplemented2 ();
     void unImplemented3 ();
-    void unImplemented4 ();
   };
 };