ACTION-1569: Create a section that describes AAPI differences

Create a section that describes AAPI differences

Cynthia Shelly
Due on:
May 3, 2016
Created on:
January 26, 2015
Associated Issue:
Related emails:
  1. PFWG-ACTION-1569: Create a section that describes AAPI differences (from on 2015-01-26)

Related notes:

"Comparing Accessibility APIs" section created in CORE-AAM on 2015-02-02 in "issue-540" branch at

Jason Kiss, 3 Jun 2015, 02:35:01

Raw git url to the new section:

Joseph Scheuhammer, 23 Jun 2015, 18:59:43

Second email sent to Jason for his thoughts. Sent privately, but it is a copy of:

Joseph Scheuhammer, 1 Feb 2016, 18:23:39

Merged in Jason's changes, see:

Marking as "pending review"

Joseph Scheuhammer, 19 Feb 2016, 20:42:22

Email to Jason (and Cynthia) for their final review:

Joseph Scheuhammer, 22 Feb 2016, 19:16:50

Latest pull request from Jason:

Joseph Scheuhammer, 9 Mar 2016, 15:49:48

Waiting on Cynthia's modified UIA example. See ACTION-2032.

Joseph Scheuhammer, 14 Mar 2016, 18:38:12

Roughly, move first sentence of ATK/AT-SPI section outside since it is more general.

Joseph Scheuhammer, 5 Apr 2016, 19:31:20

Email from Jason, suggesting some editorial changes for UIA (see below). Joseph emailed the suggestions to Cynthia for her input.

Jason's suggestions:

Hi Joseph,

All good by me. I’d just fix a few inconsistent capitalizations in the UIA section, as follows:

<p>Central to UI Automation is the concept of Control Patterns. Control Patterns allow the description of common kinds of UI element behavior. These behaviors can be grouped together to express new types of UI controls. For example, the <code>TreeItem</code> Control Type is required to support the <code>ExpandCollapse</code> Pattern, because expanding and collapsing is what defines a tree item. Tree items can optionally have other behaviors. A developer creating a <code>TreeItem</code> Control can also choose to implement the <code>Invoke</code> Control Pattern if the tree item can perform a command, <code>ScrollItem</code> Control Pattern if the tree is scrollable, and the <code>SelectionItem</code> Control Pattern if it is possible to have an active selection that is maintained when the user returns to the tree container.</p>
<p>ARIA 1.x does not directly support Control Patterns, but many of the UIA mappings in the AAM documents combine Control Patterns to express web interaction concepts that are not Control Types in UIA.</p>



Joseph Scheuhammer, 2 May 2016, 17:33:12

Confirmed Jason's suggested changes at 03-May-2016 AAPI telecon (see comment 02-May-2016).

Added those changes:


Joseph Scheuhammer, 5 May 2016, 13:52:01

Display change log.

James Nurthen <>, Valerie Young <>, Chairs, Daniel Montalvo <>, Staff Contact
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <>.
$Id: 1569.html,v 1.1 2023/05/22 16:31:50 carcone Exp $