INTEGRATION: CWS a10y01 (1.2.26); FILE MERGED

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

1 files changed, 51 insertions, 2 deletions

diff --git a/offapi/com/sun/star/awt/AccessibleComboBox.idl b/offapi/com/sun/star/awt/AccessibleComboBox.idl
index 50ac5a8b070b..e7ab32403230 100644
--- a/offapi/com/sun/star/awt/AccessibleComboBox.idl
+++ b/offapi/com/sun/star/awt/AccessibleComboBox.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: AccessibleComboBox.idl,v $
  *
- *  $Revision: 1.2 $
+ *  $Revision: 1.3 $
  *
- *  last change: $Author: vg $ $Date: 2003-04-24 17:36:57 $
+ *  last change: $Author: vg $ $Date: 2003-05-27 11:17:26 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -79,9 +79,58 @@ module com { module sun { module star { module awt {
 /** specifies accessibility support for a combo box.
 
     @see com::sun::star::accessibility::AccessibleContext
+    @see com::sun::star::accessibility::XAccessibleComponent
+    @see com::sun::star::accessibility::XAccessibleExtendedComponent
+    @since #103639#
 */
 service AccessibleComboBox
 {
+    /** This interface gives access to the structural information of a combo box:
+
+       <ul>
+       <li>Role: The role of a combo box is <const
+           scope="com::sun::star::accessibility"
+           >AccessibleRole::COMBO_BOX</const>.</li>
+       <li>Name: The name of a combo box is its localized label.</li>
+       <li>Description: The description of a combo box is its localized
+           help text.</li>
+       <li>Children: There exists two children.
+            The first is a <type scope"com::sun::star::accessibility">AccessibleTextField</type>
+            and the 2nd is a <type scope"com::sun::star::accessibility">AccessibleList</type>. </li>
+       <li>Parent: The parent is the window that contains the combo 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>
+           </ul>
+           </li>
+       </ul>
+    */
+
     service   com::sun::star::accessibility::AccessibleContext;
 
     interface com::sun::star::accessibility::XAccessibleComponent;