INTEGRATION: CWS uno4 (1.2.4); FILE MERGED

2003/05/05 15:49:53 tbe 1.2.4.1: #109171# Document accessibility service descriptions in ::com::sun::star::awt

1 files changed, 55 insertions, 2 deletions

diff --git a/offapi/com/sun/star/awt/AccessiblePopupMenu.idl b/offapi/com/sun/star/awt/AccessiblePopupMenu.idl
index 5d9cbe28bd8f..7c0d1175e66e 100644
--- a/offapi/com/sun/star/awt/AccessiblePopupMenu.idl
+++ b/offapi/com/sun/star/awt/AccessiblePopupMenu.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: AccessiblePopupMenu.idl,v $
  *
- *  $Revision: 1.2 $
+ *  $Revision: 1.3 $
  *
- *  last change: $Author: vg $ $Date: 2003-04-24 17:39:17 $
+ *  last change: $Author: vg $ $Date: 2003-05-22 09:28:20 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -81,14 +81,67 @@
 module com { module sun { module star { module awt {
 
 /** specifies accessibility support for a popup menu.
+
+    @since #108645#
  */
 service AccessiblePopupMenu
 {
+    /** This interface gives access to the structural information of a
+        popup menu:
+
+        <ul>
+        <li>Role: The role of a popup menu is <const
+            scope="com::sun::star::accessibility"
+            >AccessibleRole::POPUP_MENU</const>.</li>
+        <li>Name: There is no name.</li>
+        <li>Description: The description of a popup menu is its localized
+            help text.</li>
+        <li>Children: The children of a popup menu are menus, menu items or
+            menu separators, whose accessible context supports the services
+            <type>AccessibleMenu</type>, <type>AccessibleMenuItem</type> or
+            <type>AccessibleMenuSeparator</type>.</li>
+        <li>Parent: The parent is the window that contains the popup menu.</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::OPAQUE</const> is always set.</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>
+     */
     interface ::com::sun::star::accessibility::XAccessibleContext;
+
     interface ::com::sun::star::accessibility::XAccessibleEventBroadcaster;
+
     interface ::com::sun::star::accessibility::XAccessibleComponent;
+
     interface ::com::sun::star::accessibility::XAccessibleExtendedComponent;
+
+    /** This interface gives access to the selectable children of a
+        popup menu.
+     */
     interface ::com::sun::star::accessibility::XAccessibleSelection;
+
 };
 
 }; }; }; };