Accessibility Overview: Window Role

< Previous PageNext Page >

Hide TOC

Window Role

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

**Table B-44** Attributes associated with the window role
Attribute	Required	Type	Description
Parent	Yes	UIElement	Accessibility object representing the window’s parent
Position	Yes	Point value	Structure containing screen-position coordinates
Size	Yes	Size value	Structure containing width and height values
Subrole	Yes	String	Type of the window
Title	Yes	String	Visible title of the window
Focused	Yes	Boolean	`true` if the window is the first to receive keyboard input; `false` otherwise
Children	Yes	UIElement array	Accessibility objects representing the window’s children
Main	Yes	Boolean	`true` if the window is the main window; `false` otherwise
Minimized	Yes	Boolean	`true` if the window is minimized; `false` otherwise
Close Button	Yes	UIElement	Accessibility object representing the close button
Minimize Button	Yes	UIElement	Accessibility object representing the minimize button
Zoom Button	Yes	UIElement	Accessibility object representing the zoom button
Grow Area	Yes	UIElement	Accessibility object representing the grow area
Proxy	No	UIElement	Accessibility object representing a document window’s icon
Toolbar Button	No	UIElement	Accessibility object representing the toolbar button
Default	No	UIElement	Accessibility object representing the default button
Cancel	No	UIElement	Accessibility object representing the Cancel button
Document	No	String	URL or path for the document displayed in the window
Modal	No	Boolean	`true` if the window is modal; `false` otherwise

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

An accessibility object of the window role should have one of the following subroles:

Standard Window. The window is a standard application or document window.
Dialog. The window is a modeless dialog, such as a Find dialog.
System Dialog. The window is a system-wide modeless dialog, such as the restart dialog.
Floating Window. The window is a utility or information window, such as the Color Picker window.
System Floating Window. The window is a system-wide utility or information window, such as the About This Mac window.

< 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