Introduction to Accessibility Programming Guidelines for Cocoa

Explains how Cocoa applications make their user interface available to external assistive applications.

Who Should Read This Document?

All Cocoa application developers should read this document to learn how to access enable their applications. Even if your application uses only standard Cocoa views and controls, there is some information you need to supply to ensure your application is both completely accessible and provides a good user experience. If you’re new to accessibility or if you’re unsure why your application should be accessible, you should read Accessibility Programming Guide for OS X to learn how applications make themselves accessible to assistive technologies in OS X.

If you’re an assistive application developer, you don’t need to read this document. Instead, you should read Accessibility Programming Guide for OS X to become familiar with the OS X accessibility architecture and learn about the attributes associated with each type of accessibility object.

Organization of This Document

The following articles describe how Cocoa implements accessibility:

Accessibility Objects and the Accessibility Hierarchy describes the accessibility object as it is implemented by the Application Kit. It also describes the accessibility hierarchy that represents an application and discusses how an assistive application interacts with the accessibility objects in your application.

Hit-Testing and Keyboard Focus discusses how an assistive application can access user interface objects by screen position and by keyboard focus.

Accessibility Notifications discusses how an application notifies assistive applications that some change has occurred in the user interface, such as a new window opening.

The following articles describe how to access enable your application:

Access Enabling a Cocoa Application provides guidance on which tasks you may need to perform to access enable your application.

Supporting Attributes describes how to add an attribute to a custom accessible object.

Supporting Actions describes how to add an action to a custom accessible object.

Manipulating the Accessibility Hierarchy describes how to change an accessibility object’s status in the accessibility hierarchy.

Introduction to Accessibility Programming Guidelines for Cocoa

Who Should Read This Document?

Organization of This Document

See Also