XMSAALib - a non-MFC class to retrieve accessibility (MSAA) info

• Download demo project - 152 Kb

Introduction

This article does not discuss how to implement MSAA in an application. If that is what you are interested in, you should read this article.

Demo App

	The Start Event Handler button calls SetWinEventHook(), which causes a hook function to be called when a window receives the focus - in this case, when the Firefox address bar is clicked: The hook function calls AccessibleObjectFromEvent() and then calls user-supplied callback function with IAccessible pointer. The callback function can then call any of the IAccessible functions to retrieve whatever information is necessary.
	The Enum All Browser Objects button calls EnumAccessible() to iterate through all IAccessible child objects of browser window (the browser is selected by four radio buttons): The child object information is shown in listbox, and is also written to a file in XML format during enumeration - the button Display Object Tree displays the resulting object tree using XHtmlTree: I adapted code for EnumAccessible() from this MSDN article.
	The Get Browser Address Bar button retrieves the URL value currently contained in the address (or location) bar: The code to get address bar is another example of how to use EnumAccessible() to enumerate child objects. To find address bar, we have to be aware of how various browsers implement MSAA information for address bar object. The following table shows this information for major browsers: Browser Address Bar Object Characteristics Browser Name Role Value Firefox 2 -  editable text http://www.codeproject.com/ Firefox 3 Location editable text http://www.codeproject.com/ Internet Explorer 6 Address editable text http://www.codeproject.com/ Internet Explorer 7 Address editable text http://www.codeproject.com/ Google Chrome 1.0 Location editable text http://www.codeproject.com/ Opera 9 -  -  -  Opera 10 alpha -  editable text http://www.codeproject.com/ Safari 3 -  -  -  Of the major browsers in use, Opera 9 and Safari 3 fail to provide address bar information via IAccessible. As the table shows, Opera has now implemented this in version 10. It is unknown whether Apple plans to add this to Safari. The key characteristics to look for in the callback function is an object role of editable text. Next, the object name can have one of three values: empty (or nameless), Location, and Address. Finally, we look for the http URL specifier in the object value. This approach allows us to query the current URL of most browsers.

MSAA Development Tools

1. AccExplorer32 - this tool displays the object tree for any MSAA-enabled window.

   First, click on the Build New Tree toolbar button:

   

   Then drag the crosshairs over the window you want to explore:

   

   When you release the crosshairs, the object tree will be built and displayed:

   

   You can then go to File | Save to save the object tree to a file.

2. Inspect32 - this tool dynamically displays the IAccessible properties when the cursor hovers over an MSAA-enabled window. In the screenshot below, the cursor is over the Firefox 3 address bar:

   

   Of these two tools, Inspect32 seems to have more stability problems, so I usually close it after I have what I need.

CXMSAALib Functions

How To Use

To integrate CXMSAALib into your own program, you first need to add following files to your project:

• XMSAALib.cpp
• XMSAALib.h

If you do not include stdafx.h in XMSAALib.cpp, then you must mark XMSAALib.cpp as not using precompiled headers in the project settings.

Next, include the header file XMSAALib.h in the module where you want to call XMSAALib functions.

For more details on how to use, please see XMSAALibTestDlg.cpp.

MSAA Resources

• Microsoft Active Accessibility
• Active Accessibility 2.0 SDK Tools - must-have tools for developing with MSAA, especially AccExplorer32.exe and inspect32.exe.
• Microsoft Accessibility Developer Center
• The IAccessible Interface
• IAccessible COM interface
• Microsoft Active Accessibility: Architecture, Part 1
• Microsoft Active Accessibility: Architecture, Part 2
• MSDN Magazine - Software Driving Software: Active Accessibility-Compliant Apps Give Programmers New Tools to Manipulate Software by Dmitri Klementiev
• Sara Ford's WebLog: The Fundamentals of Accessibility
• Sara Ford - Accessibility and Visual Studio (Channel 9 video)
• UI Automation and Microsoft Active Accessibility - describes the differences between UIA and MSAA.

CodeProject Articles Used/Referenced in this Article

• Introduction to Microsoft Active Accessibility
• Add XP Visual Style Support to OWNERDRAW Controls
• XHtmlDraw - Draw text with HTML tags and anchor links
• XHyperLink - yet another hyperlink control
• XListBox - Owner-draw CListBox with selectable text and background colors
• XString - non-MFC non-STL string functions
• XHtmlTree - Tree control with support for HTML, XML, Smart Checkboxes, and Drag & Drop

Revision History

Version 1.0 - 2009 February 10

• Initial public release

Usage

This software is released into the public domain. You are free to use it in any way you like, except that you may not sell this source code. If you modify it or extend it, please to consider posting new code here for everyone to share. This software is provided "as is" with no expressed or implied warranty. I accept no liability for any damage or loss of business that this software may cause.

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)