Accessibility Overview: Combo Box Role

Contact ADC

< Previous PageNext Page >

Hide TOC

Combo Box Role

An accessibility object of the combo box role includes the following attributes as shown in Table B-7:

**Table B-7** Attributes associated with the combo box role
Attribute	Required	Type	Description
Parent	Yes	UIElement	Accessibility object representing the combo box’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 combo box’s containing window
Top-Level UIElement	Yes	UIElement	Accessibility object representing the combo box’s containing window, sheet, or drawer
Help	No	String	Help-tag text for the combo box
Enabled	Yes	Boolean	`true` if the user can interact with the combo box; `false` if interaction is disabled
Focused	Yes	Boolean	`true` if the combo box is focused; `false` otherwise
Value	Yes	String	Text of the currently selected item
Children	Yes	UIElement array	Accessibility objects representing the disclosure button and (when expanded) the scroll area
Expanded	Yes	Boolean	`true` when the list is displayed; `false` otherwise
Selected Text	No	String	Selected portion of the text of the currently selected item
Selected Text Range	No	Range value	Position and length (in characters) of the selected portion of the text of the currently selected item
Number of Characters	No	Number	Number of characters in the selected portion of the text of the currently selected item
Visible Character Range	No	Range value	Position and length (in characters) of the text of the currently selected item
Description	Yes	String	Human-intelligible description of the combo box. Not required if the title UIElement attribute is included.
Title UIElement	No	UIElement	Accessibility object representing the static text that serves as the title for the combo box
Insertion Point Line Number	No	Number	Line number of current cursor position in combo box

Note: Combo boxes also support parameterized attributes. See the framework-specific documentation for more information on these attributes.

An accessibility object of the combo box role supports the following action:

Confirm. When the confirm action is performed, the selected list item is displayed in the combo box’s text field.

< 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