Accessibility Overview: Checkbox Role

< Previous PageNext Page >

Hide TOC

Checkbox Role

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

**Table B-5** Attributes associated with the checkbox role
Attribute	Required	Type	Description
Parent	Yes	UIElement	Accessibility object representing the checkbox’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 checkbox’s containing window
Top-Level UIElement	Yes	UIElement	Accessibility object representing the checkbox’s containing window, sheet, or drawer
Help	No	String	Help-tag text for the checkbox
Enabled	Yes	Boolean	`true` if the user can interact with the checkbox; `false` if interaction is disabled
Focused	Yes	Boolean	`true` if the checkbox is focused; `false` otherwise
Title	Yes	String	Visible title of the checkbox. Not required if the checkbox does not display a title in its visible interface.
Value	Yes	Number	Value of the checkbox (checked is `1`, unchecked is `0`, and mixed state is `2`)
Description	No	String	Human-intelligible description of the checkbox. Required if the checkbox does not display a title.

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

< 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