INTEGRATION: CWS a10y01 (1.2.26); FILE MERGED

2003/05/22 11:19:48 oj 1.2.26.1: #103639# document services

1 files changed, 53 insertions, 5 deletions

diff --git a/offapi/com/sun/star/awt/AccessibleToolBox.idl b/offapi/com/sun/star/awt/AccessibleToolBox.idl
index 1724f17929ad..47c2957ce864 100644
--- a/offapi/com/sun/star/awt/AccessibleToolBox.idl
+++ b/offapi/com/sun/star/awt/AccessibleToolBox.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: AccessibleToolBox.idl,v $
  *
- *  $Revision: 1.2 $
+ *  $Revision: 1.3 $
  *
- *  last change: $Author: vg $ $Date: 2003-04-24 17:41:03 $
+ *  last change: $Author: vg $ $Date: 2003-05-27 11:19:35 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -81,14 +81,62 @@ module com { module sun { module star { module awt {
 /** specifies accessibility support for a tool box.
 
     @see com::sun::star::accessibility::AccessibleContext
-
     @see com::sun::star::accessibility::XAccessibleComponent
     @see com::sun::star::accessibility::XAccessibleExtendedComponent
-
-
+    @since #103639#
 */
 service AccessibleToolBox
 {
+    /** This interface gives access to the structural information of a tool box:
+
+       <ul>
+       <li>Role: The role of a tool box is <const
+           scope="com::sun::star::accessibility"
+           >AccessibleRole::TOOL_BAR</const>.</li>
+       <li>Name: The name of a tool box is its localized label.</li>
+       <li>Description: The description of a tool box is its localized
+           help text.</li>
+       <li>Children: There exists children of type <type scope"com::sun::star::accessibility">AccessibleToolBoxItem</type>.
+       </li>
+       <li>Parent: The parent is the window that contains the tool box.</li>
+       <li>Relations: There are no relations.</li>
+       <li>States: The states supported by this service are
+           <ul>
+           <li><const scope="com::sun::star::accessibility"
+               >AccessibleStateType::DEFUNC</const>
+               is set if the object has already been disposed
+               and subsequent calls to this object result in
+               <type scope="com::sun::star::lang">DisposedException</type>
+               exceptions.</li>
+           <li><const scope="com::sun::star::accessibility"
+               >AccessibleStateType::ENABLED</const> is set
+               if the object is enabled.</li>
+           <li><const scope="com::sun::star::accessibility"
+               >AccessibleStateType::FOCUSABLE</const> is always set.</li>
+           <li><const scope="com::sun::star::accessibility"
+               >AccessibleStateType::FOCUSED</const> is set
+               if the object currently has the keyboard focus.</li>
+           <li><const scope="com::sun::star::accessibility"
+               >AccessibleStateType::ACTIVE</const> is set
+               if a child has currently the focus.</li>
+           <li><const scope="com::sun::star::accessibility"
+               >AccessibleStateType::RESIZABLE</const> is set
+               if the object can be resized.</li>
+           <li><const scope="com::sun::star::accessibility"
+               >AccessibleStateType::SHOWING</const> is set
+               if the object is displayed on the screen.</li>
+           <li><const scope="com::sun::star::accessibility"
+               >AccessibleStateType::VISIBLE</const> is always set.</li>
+           <li><const scope="com::sun::star::accessibility"
+               >AccessibleStateType::VERTICAL</const> is set
+               if the tool box is vertical.</li>
+           <li><const scope="com::sun::star::accessibility"
+               >AccessibleStateType::HORIZONTAL</const> is set
+               if the tool box is horizontal.</li>
+           </ul>
+           </li>
+       </ul>
+    */
     service   com::sun::star::accessibility::AccessibleContext;
 
     interface com::sun::star::accessibility::XAccessibleComponent;