Updates for 1.1 from 20090831.

api/Accessible2.idl

@@ -4,7 +4,7 @@
  *
  *  IAccessible2 IDL Specification
  *
- *  Copyright (c) Linux Foundation 2007, 2008
+ *  Copyright (c) Linux Foundation 2007, 2009
  *  Copyright (c) IBM Corp. 2006
  *  Copyright (c) Sun Microsystems, Inc. 2000, 2006
  *
@@ -35,7 +35,9 @@
   IAccessibleHyperlink\n
   IAccessibleImage\n
   IAccessibleRelation\n
-  IAccessibleTable\n
+  IAccessibleTable [deprecated]\n
+  IAccessibleTable2\n
+  IAccessibleTableCell\n
   IAccessibleText\n
   IAccessibleEditableText\n
   IAccessibleValue
@@ -58,7 +60,7 @@
  @section _constants Constants
   @ref grpRelations
 
- @section _license Miscellaneous
+ @section _misc Miscellaneous
   @ref _licensePage "LGPL License"\n
   @ref _generalInfo "General Information"\n
 
@@ -99,12 +101,13 @@
  @ref _applicationInfo\n
  @ref _childIDs\n
  @ref _variants\n
- @ref _iaaction-iahyperlink
+ @ref _iaaction-iahyperlink\n
+ @ref _trademark
 
  @section _errors Error Handling
-  HRESULT values are defined by the Microsoft Win32 API.  For more information, refer to 
+  HRESULT values are defined by the Microsoft® Win32® API.  For more information, refer to 
   <a href="http://msdn2.microsoft.com/en-us/library/bb401631.aspx">Interpreting HRESULT Values</a>
-  in MSDN.
+  in MSDN&reg;.
 
   Note that the S_FALSE return value is considered a non-error value and the 
   SUCCEEDED macro will return TRUE.  S_FALSE is used when there is no failure
@@ -178,11 +181,11 @@
 
  @section _dicoveringInterfaces Discovery of Interfaces
   In general AT (Assistive Technology) should try IAccessible2 interfaces, followed by using 
-  the MSAA interfaces.  (In cases where the an application is known to have custom interfaces 
-  which provide information not supplied by IAccessible2 or MSAA, then those custom interfaces 
-  can be used.)  The AT can then, by default, support unknown IAccessible2/MSAA applications, 
-  without the application developers having to request AT vendors for support on an individual 
-  application by application basis.
+  the MSAA (Microsoft&reg; Active Accessibility&reg;) interfaces.  (In cases where the an application
+  is known to have custom interfaces which provide information not supplied by IAccessible2
+  or MSAA, then those custom interfaces can be used.)  The AT can then, by default, support
+  unknown IAccessible2/MSAA applications, without the application developers having to request
+  AT vendors for support on an individual application by application basis.
 
   When you have a reference to an IAccessible and require a reference to an IAccessible2 use 
   QueryService as follows:
@@ -228,7 +231,7 @@
    easily implement the interface on the same object or a separate object. The latter is 
    often hard to do with QueryInterface unless the original object supports aggregation. 
 
-  Two related references in MSDN are: 
+  Two related references in MSDN&reg; are: 
   @li <a href="http://msdn.microsoft.com/en-us/library/ms696078(VS.85).aspx">
   "Using QueryService to expose a native object model interface for an IAccessible object"</a>
   @li <a href="http://msdn.microsoft.com/en-us/library/ms528415.aspx#acc_obj"> 
@@ -237,16 +240,13 @@
   Based on this information from Microsoft, QueryService must be used to switch back and forth 
   between a reference to an MSAA IAccessible interface and any of the IAccessible2 interfaces. 
 
-  Regarding switching between any of the IAccessible2 interfaces, ATs typically use QueryInterface.  
-  This is because it is typical for applications implementing IAccessible2 to implement all 
-  IAccessible2 interfaces on a single object.  However it is possible that an application could 
-  use more than one object to implement the full set of IAccessible2 interfaces and as a result 
-  QueryService would have to be used.  If your AT is using the IAccessible2 interfaces and you want 
-  to allow for access to the widest range of existing and future applications you should use 
-  QueryService rather than QueryInterface.  If the interface being switched to is implemented on 
-  the same object there shouldn't be a noticeable difference in performance and if the interface is 
-  implemented on another object the application can transfer the request to the secondary object 
-  saving exception handling code in the AT. 
+  Regarding switching between any of the IAccessible2 interfaces, applications implementing
+  IAccessible2 should implement the IAccessible2 interfaces on a single object since ATs
+  will be using QueryInterface to switch between the IAccessilbe2 interfaces.  Implementing
+  the IAccessible2 interfaces on separate objects would require the use of QueryService.
+  There is one exception, IAccessibleApplication can be implemented on a separate object so
+  its common code doesn't have to be included in each accessible object.  ATs should use
+  QueryService to access IAccessibleApplication.
 
  @section _applicationInfo Access to Information about the Application
   Servers implementing IAccessible2 should provide access to the IAccessibleApplication 
@@ -279,6 +279,12 @@
   have actionable objects; it's the secondary smart tags that are actionable.  As a 
   result, implementations should not rely on the inheritance as it may be removed in 
   a later version of the IDL.
+
+ @section _trademark Trademark Attribution
+  The names of actual companies and products mentioned herein may be the trademarks of
+  their respective owners.  In particular, Active Accessibility, Microsoft, MSDN, and Win32
+  are trademarks of the Microsoft group of companies in the U.S.A. and/or other countries.
+
 **/
 
 import "objidl.idl";
@@ -522,9 +528,11 @@ interface IAccessible2 : IAccessible
    current window, and remains the same for the lifetime of the accessible
    object. 
 
-   The uniqueID is not related to the MSAA objectID which is used by the server 
-   to disambiguate between IAccessibles per HWND or the MSAA childID which is 
-   used to disambiguate between children being managed by an IAccessible.
+   The uniqueID is not related to:
+   - the MSAA objectID which is used by the server to disambiguate between
+   IAccessibles per HWND or
+   - the MSAA childID which is used to disambiguate between children being
+   managed by an IAccessible.
 
    This value is provided so the AT can have access to a unique runtime persistent 
    identifier even when not handling an event for the object.
@@ -535,7 +543,7 @@ interface IAccessible2 : IAccessible
    Thus, if there's a REORDER/SHOW/HIDE event the AT knows which part of the 
    internal structure has been invalidated and can refetch just that part.
 
-   This value can also be used by and AT to determine when the current control
+   This value can also be used by an AT to determine when the current control
    has changed. If the role is the same for two controls that are adjacent in 
    the tab order, this can be used to detect the new control.
 

api/AccessibleHypertext.idl

@@ -35,7 +35,7 @@ import "AccessibleHyperlink.idl";
  The %IAccessibleHypertext interface is the main interface to expose
   hyperlinks in a document, typically a text document, that are used 
   to reference other documents.  A typical implementation is to implement 
-  this interface the smallest text object such as a paragraph of text.
+  this interface on the smallest text object such as a paragraph of text.
 */
 [object, uuid(6B4F8BBF-F1F2-418a-B35E-A195BC4103B9)]
 interface IAccessibleHypertext : IAccessibleText

api/AccessibleRelation.idl

@@ -4,7 +4,7 @@
  *
  *  IAccessible2 IDL Specification
  *
- *  Copyright (c) Linux Foundation 2007, 2008
+ *  Copyright (c) Linux Foundation 2007, 2009
  *  Copyright (c) IBM Corp. 2006
  *  Copyright (c) Sun Microsystems, Inc. 2000, 2006
  *
@@ -55,7 +55,11 @@ const WCHAR *const IA2_RELATION_EMBEDDED_BY = L"embeddedBy";
 */
 const WCHAR *const IA2_RELATION_EMBEDS = L"embeds";
 
-/** Content flows to this object from a target object. */
+/** Content flows to this object from a target object. 
+ This relation and IA2_RELATION_FLOWS_TO are useful to tie text and non-text
+ objects together in order to allow assistive technology to follow the
+ intended reading order.
+*/
 const WCHAR *const IA2_RELATION_FLOWS_FROM = L"flowsFrom";
 
 /** Content flows from this object to a target object. */
@@ -102,6 +106,7 @@ interface IAccessibleRelation : IUnknown
 {
   /** @brief Returns the type of the relation.
    @param [out] relationType
+    The strings returned are defined @ref grpRelations "in this section of the documentation".
    @retval S_OK
   */
   [propget] HRESULT relationType

api/AccessibleRole.idl

@@ -74,7 +74,11 @@ enum IA2Role {
   */
   IA2_ROLE_DIRECTORY_PANE,
 
-  /// An editable text object in a toolbar.
+  /** An editable text object in a toolbar.
+   <BR><B>Note:</B> This role has been deprecated.  The edit bar role was meant
+   for a text area in a tool bar. However, to detect a text area in a tool bar
+   the AT can query the parent.
+  */
   IA2_ROLE_EDITBAR,
 
   /// Embedded (OLE) object.

api/AccessibleTable.idl

@@ -4,7 +4,7 @@
  *
  *  IAccessible2 IDL Specification
  *
- *  Copyright (c) Linux Foundation 2007, 2008
+ *  Copyright (c) Linux Foundation 2007, 2009
  *  Copyright (c) IBM Corp. 2006
  *  Copyright (c) Sun Microsystems, Inc. 2000, 2006
  *
@@ -28,32 +28,7 @@ import "objidl.idl";
 import "oaidl.idl";
 import "oleacc.idl";
 import "Accessible2.idl";
-
-/** These constants specify the kind of change made to a table.
-
-   This enum is used in the IA2TableModelChange struct which in turn is used by IAccessibleTable::modelChange.
-*/
-enum IA2TableModelChangeType {
-  IA2_TABLE_MODEL_CHANGE_INSERT,  // = 0;
-  IA2_TABLE_MODEL_CHANGE_DELETE,
-  IA2_TABLE_MODEL_CHANGE_UPDATE
-};
-
-/** A structure defining the type of and extents of changes made to a table
-
- IAccessibleTable::modelChange returns this struct.  In the case of an insertion
- or change the row and column offsets define the boundaries of the inserted or 
- changed subtable after the operation.  In the case of a deletion the row and 
- column offsets define the boundaries of the subtable being removed before the
- removal.
-*/
-typedef struct IA2TableModelChange {
-  enum IA2TableModelChangeType type;	// insert, delete, update
-  long firstRow;		///< 0 based, inclusive
-  long lastRow;			///< 0 based, inclusive
-  long firstColumn;		///< 0 based, inclusive
-  long lastColumn;		///< 0 based, inclusive
-} IA2TableModelChange;
+import "IA2CommonTypes.idl";
 
 /** @brief This interface gives access to a two-dimensional table. 
 
@@ -76,6 +51,9 @@ typedef struct IA2TableModelChange {
   However, that range includes at least the intervals from the from the first row 
   or column with the index 0 up to the last (but not including) used row or column 
   as returned by IAccessibleTable::nRows and IAccessibleTable::nColumns.
+
+ Note that newer implementations are now using IAccessibleTable2 and IAccessibleTableCell
+  rather than this interface.
 */
 [object, uuid(35AD8070-C20C-4fb4-B094-F4F7275DD469)]
 interface IAccessibleTable : IUnknown