Accessibility Overview: Button Role

< Previous PageNext Page >

Hide TOC

Button Role

An accessibility object of the button role includes the following attributes as shown in Table B-4:

**Table B-4** Attributes associated with the button role
Attribute	Required	Type	Description
Parent	Yes	UIElement	Accessibility object representing the button’s parent
Position	Yes	Point value	Structure containing screen-position coordinates
Size	Yes	Size value	Structure containing width and height values
Window	Yes	UIElement	Accessibility object representing the button’s containing window
Top-Level UIElement	Yes	UIElement	Accessibility object representing the button’s containing window, sheet, or drawer
Help	No	String	Help-tag text for the button
Enabled	Yes	Boolean	`true` if the user can interact with the button; `false` if interaction is disabled
Focused	Yes	Boolean	`true` if the button is focused; `false` otherwise
Title	Yes	String	Visible title of the button. Not required if the button does not display a title in its visible interface.
Subrole	No	String	Type of the button. Required if the button is a close, zoom, minimize, toolbar, or sort button.
Edited	No	Boolean	`true` if the contents of the window have been edited; `false` otherwise. Required only if the button is a close button.
Description	No	String	Human-intelligible description of the button. Required if the button does not display a title.

An accessibility object of the button role supports the following action:

An accessibility object of the button role can have one of the following subroles:

Close Button. The button represents the close button in a window.
Minimize Button. The button represents the minimize button in a window.
Zoom Button. The button represents the zoom button in a window.
Toolbar Button. The button represents the button to hide and reveal the toolbar in a window.
Increment Arrow. The button represents the increment scroll arrow in a scroll bar object.
Decrement Arrow. The button represents the decrement scroll arrow in a scroll bar object.
Increment Page. The button represents the increment-page area of the scroll track in a scroll bar object.
Decrement Page. The button represents the decrement-page area of the scroll track in a scroll bar object.
Sort Button. The button represents a sort button.

< Previous PageNext Page >

Hide TOC

Last updated: 2008-03-11

Did this document help you?
Yes: Tell us what works for you. It’s good, but: Report typos, inaccuracies, and so forth. It wasn’t helpful: Tell us what would have helped.




	Get information on Apple products. Visit the Apple Store online or at retail locations. 1-800-MY-APPLE Copyright © 2007 Apple Inc. All rights reserved. \| Terms of use \| Privacy Notice