TECHNICAL ISO/IEC TR REPORT 13066-2 Second edition 2016-02-01 Information technology Interoperability with assistive technology (AT) - Part 2: Windows accessibility application programming interface (API) Technologies de I'information Interopérabilite avec les technologies d'assistance Partie 2: Interface de programmation d'applications (API) d'accessibilité Windows Reference number IS0/IEC TR 13066-2:2016(E) E( Ts . International Organization for Standardization STANDARDIZATION C15956617 @ IS0/IEC 2016 ed without license from IHS IS0/IEC TR 13066-2:2016(E) COPYRIGHT PROTECTED DOCUMENT IS0/IEC 2016, Published in Switzerland All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized otherwise in any form written permission. Permission can be requested from either ISO at the address below or ISO's member body in the country of the requester. ISO copyright office Ch. de Blandonnet 8 . CP 401 CH-1214 Vernier, Geneva, Switzerland Tel. +41 22 749 01 11 Fax +41 22 749 09 47 [email protected] www.iso.org brganizationfor Standardization Licensee-ZHEJIANG INST.OF STANDRJSQ/6NEC6- All rights reserved HS und Not for Resale, 2016/4/22 07:56:54 No reproduction or networking permited without license from IHS IS0/IEC TR 13066-2:2016(E) Contents Page Foreword ..V Introduction.. ...vi 1 Scope. ..1 2 Terms and definitions 3 General description and architecture of the Microsoft Windows Automation API ..7 3.1 General description... .7 3.1.1 Microsoft Active Accessibility overview 3.1.2 UI Automation overview ..8 3.1.3 IAccessibleEx interface. ..9 3.2 Architecture ..10 4 Using the API ..12 4.1 Using the Microsoft Active Accessibility API .12 4.1.1 Types of Microsoft Active Accessibility support ..13 4.1.2 Retrieving an accessible object ..13 4.1.3 The WM_GETOBJECT message ..13 4.1.4 Special values of Object Identifier. .14 4.2 Using the UI Automation API .15 4.2.1 UI Automation model. .15 4.2.2 UI Automation tree. ..16 4.2.3 UI Automation control patterns, control types, properties, and events. .16 4.3 Using the IAccessibleEx interface 21 4.3.1 The IAccessibleEx interface implementation 21 5 Exposing User Interface Element Information .24 5.1 General 24 5.2 Exposing UI Elements with Microsoft Active Accessibility. .25 5.2.1 How an MSAA Server exposes relevant properties. .25 5.2.2 Provide support for the Accessible Object structure 26 5.2.3 Support hit testing. 27 5.2.4 Generate appropriate WinEvents 27 5.2.5 Object identifier. 27 5.2.6 How MSAA clients access exposed UI elements 28 5.3 Exposing UI Elements with UI Automation .28 5.3.1 Types of providers. 28 5.3.2 Ul Automation provider concepts 28 5.3.3 Provider interfaces.. 29 5.3.4 Property values. .30 5.3.5 Provider navigation. 30 5.3.6 Provider reparenting. 31 5.3.7 Provider repositioning 31 5.3.8 How UI Automation clients access exposed UI Elements. .32 6 Exposing UI Element actions .33 6.1 Exposing UI Element actions in MSAA 33 6.2 Exposing UI Element actions in UI Automation . 33 6.2.1 UI Automation control pattern components. 33 6.2.2 Control patterns in providers and clients 6.2.3 Dynamic control patterns ..34 6.2.4 Controlpatternsandrelatedinterfaces. ..34 7 Keyboard focus .36 7.1 MSAA keyboard focus and selection ..36 7.1.1 Focus and selection properties and methods .36 7.1.2 Events triggered in menus. ..37 7.2 UI Automation keyboard focus and selection .37 ntemaionalganzationEG2016Allrighsrved ii Licensee=ZHEJIANG INST OF STANDARDIZATION C1 5956617 ted without license from IHS Not for Resale, 2016/4/22 07:56:54 IS0/IEC TR 13066-2:2016(E) 7.2.1 Focus. .37 7.2.2 Selection .38 8 Events 44 8.1 WinEvents 44 8.1.1 USER's role in WinEvents 44 8.1.2 Receiving event notifications 45 8.1.3 Sending events. 45 8.1.4 The allocation of WinEvent IDs. 45 8.2 UI Automation events 46 8.2.1 How providers raise events 47 8.2.2 How clients register for and process events 48 9 Programmatic modifications of states, properties, values, and text .48 9.1 UI Auto