2004-02-11 Padraig O'Briain <padraig.obriain@sun.com>
[platform/core/uifw/at-spi2-atk.git] / idl / Accessibility_State.idl
index 7e37256..9c43288 100644 (file)
@@ -37,8 +37,12 @@ module Accessibility {
   STATE_CHECKED,
   /* Indicates this object is collapsed */
   STATE_COLLAPSED,
+  /* Indicates that this object no longer contains a backing widget */
+  STATE_DEFUNCT,
   /* Indicates the user can change the contents of this object */
   STATE_EDITABLE,
+  /* Indicates that this object is enabled */
+  STATE_ENABLED,
   /* Indicates this object allows progressive disclosure of its children */
   STATE_EXPANDABLE,
   /* Indicates this object its expanded */
@@ -96,16 +100,32 @@ module Accessibility {
   STATE_SHOWING,
   /* Indicates this (text) object can contain only a single line of text */
   STATE_SINGLE_LINE,
+  /* Indicates that this object's index within parent information may be invalid */
+  STATE_STALE,
   /* Indicates this object is transient */
   STATE_TRANSIENT,
   /* Indicates the orientation of this object is vertical */
   STATE_VERTICAL,
   /* Indicates this object is visible */
   STATE_VISIBLE,
+  /*
+   * Indicates that "active-descendant-changed" event is sent when children
+   * become 'active' (i.e. are selected or navigated to onscreen).  Used to
+   * prevent need to enumerate all children in very large containers, like
+   * tables.
+   */
+  STATE_MANAGES_DESCENDANTS,
+  /*
+   * Indicates that a check box is in a state other than checked or not checked.
+   */
+  STATE_INDETERMINATE,
+
   STATE_LAST_DEFINED
   };
 
-  interface StateSet {
+  typedef sequence <StateType> StateSeq;
+
+  interface StateSet : Bonobo::Unknown {
     boolean            contains (in StateType state);
     void               add (in StateType state);
     void               remove (in StateType state);
@@ -113,6 +133,19 @@ module Accessibility {
     /* returns a 'difference set' */
     StateSet            compare (in StateSet compareState);
     boolean            isEmpty ();
+
+    /* Private */
+    StateSeq getStates ();
+
+    /**
+     * unImplemented:
+     *
+     * placeholders for future expansion.
+     */
+    void unImplemented ();
+    void unImplemented2 ();
+    void unImplemented3 ();
+    void unImplemented4 ();
   };
 };