Subroles

Application Dock Item

Subrole for an application Dock item.

Pseudoclass: AXApplicationDockItem

Cocoa constant: (none defined)

Carbon constant: kAXApplicationDockItemSubrole (Available in OS X v10.4 and later.)

Subrole of “Dock Item.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Is Application Running”

Flag that indicates whether an application is running, as represented in the Dock. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Selected”

Flag that indicates whether a UI element is selected. May be settable.

“Shown Menu UI Element”

Accessibility object representing the Dock item’s Dock menu. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“URL”

URL or path associated with an element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

“Show Menu”

Simulates showing a menu by clicking it.

Close Button

Subrole for a window’s close button.

Pseudoclass: AXCloseButton

Cocoa constant: NSAccessibilityCloseButtonSubrole (Available in OS X v10.2 and later.)

Carbon constant: kAXCloseButtonSubrole (Available in OS X v10.2 and later.)

Subrole of “Button.”

Required Attributes

“Edited”

Flag that indicates whether a UI element has unsaved changes. Must not be settable.

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

Content List

Subrole for a list used as content.

Pseudoclass: AXContentList

Cocoa constant: NSAccessibilityContentListSubrole (Available in OS X v10.6 and later.)

Carbon constant: kAXContentListSubrole (Available in OS X v10.6 and later.)

Subrole of “List.”

Discussion

List elements used as content are commonly found in webpages and word-processing documents, and are typically numbered or bulleted. In webpages, this subrole corresponds to the <ul> and <ol> tags. List elements using this subrole are expected to always return an empty array as the value of the AXSelectedChildren attribute, and for that attribute not to be writable. Assistive applications treat UI elements with this subrole as static entities, not as controls.

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. May be settable.

“Orientation”

Horizontal or vertical orientation of an element—for example, a list, ruler, scroll bar, or splitter bar. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Selected Children”

Currently selected child elements of a UI element. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Visible Children”

Currently visible child elements of a UI element. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Decrement Arrow

Subrole for the button representing the decrement arrow (the down arrow in a scroll bar).

Pseudoclass: AXDecrementArrow

Cocoa constant: NSAccessibilityDecrementArrowSubrole (Available in OS X v10.3 and later.)

Carbon constant: kAXDecrementArrowSubrole (Available in OS X v10.3 and later.)

Subrole of “Button.”

Required Attributes

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

Decrement Page

Subrole for the button representing the decrement-page area of the scroll track in a scroll bar.

Pseudoclass: AXDecrementPage

Cocoa constant: NSAccessibilityDecrementPageSubrole (Available in OS X v10.3 and later.)

Carbon constant: kAXDecrementPageSubrole (Available in OS X v10.3 and later.)

Subrole of “Button.”

Required Attributes

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

Definition List

Subrole for a list of terms and definitions.

Pseudoclass: AXDefinitionList

Cocoa constant: NSAccessibilityDefinitionListSubrole (Available in OS X v10.6 and later.)

Carbon constant: kAXDefinitionListSubrole (Available in OS X v10.6 and later.)

Subrole of “List.”

Discussion

AXList elements using this subrole are expected to always return an empty array as the value of the AXSelectedChildren attribute, and for that attribute not to be writable.

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. May be settable.

“Orientation”

Horizontal or vertical orientation of an element—for example, a list, ruler, scroll bar, or splitter bar. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Selected Children”

Currently selected child elements of a UI element. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Visible Children”

Currently visible child elements of a UI element. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Dialog

Subrole for a dialog.

Pseudoclass: AXDialog

Cocoa constant: NSAccessibilityDialogSubrole (Available in OS X v10.3 and later.)

Carbon constant: kAXDialogSubrole (Available in OS X v10.3 and later.)

Subrole of “Window.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Close Button”

Accessibility object representing a window’s close button. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. Must not be settable.

“Main”

Flag that indicates whether a window is the main window of an application. May be settable.

“Minimize Button”

Accessibility object that represents a window’s minimize button. Must not be settable.

“Minimized”

Flag that indicates whether a window is currently minimized in the Dock. May be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must be settable.

“Title”

Visible text title of an element. Must not be settable.

“Zoom Button”

Accessibility object representing the zoom button. Must not be settable.

Optional Attributes

“Cancel Button”

Accessibility object representing the window’s cancel button (if any). Must not be settable.

“Default Button”

Accessibility object representing the default button of a window or sheet. Must not be settable.

“Document”

URL or path for the document displayed in a window. Must not be settable.

“Full Screen Button”

Accessibility object representing the full-screen button of a window. Must not be settable.

“Grow Area”

Accessibility object representing the grow area element of a window or sheet. Must not be settable.

“Modal”

Flag that indicates whether the window represented by an element is modal. Must not be settable.

“Proxy”

Accessibility object representing a window’s document proxy element. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title UI Element”

UI element that represents another element’s static text title. Must not be settable.

“Toolbar Button”

Accessibility object representing the button that hides and reveals a window’s toolbar. Must not be settable.

Actions

“Raise”

Simulates bringing a window forward by clicking in its title bar.

Dock Extra Dock Item

Subrole for a Dock extra.

Pseudoclass: AXDockExtraDockItem

Cocoa constant: (none defined)

Carbon constant: kAXDockExtraDockItemSubrole (Available in OS X v10.4 and later.)

Subrole of “Dock Item.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Selected”

Flag that indicates whether a UI element is selected. May be settable.

“Shown Menu UI Element”

Accessibility object representing the Dock item’s Dock menu. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“URL”

URL or path associated with an element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

“Show Menu”

Simulates showing a menu by clicking it.

Document Dock Item

Subrole for a document displayed in the Dock.

Pseudoclass: AXDocumentDockItem

Cocoa constant: (none defined)

Carbon constant: kAXDocumentDockItemSubrole (Available in OS X v10.4 and later.)

Subrole of “Dock Item.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Selected”

Flag that indicates whether a UI element is selected. May be settable.

“Shown Menu UI Element”

Accessibility object representing the Dock item’s Dock menu. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“URL”

URL or path associated with an element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

“Show Menu”

Simulates showing a menu by clicking it.

Floating Window

Subrole for a floating window.

Pseudoclass: AXFloatingWindow

Cocoa constant: NSAccessibilityFloatingWindowSubrole (Available in OS X v10.3 and later.)

Carbon constant: kAXFloatingWindowSubrole (Available in OS X v10.3 and later.)

Subrole of “Window.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Close Button”

Accessibility object representing a window’s close button. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. Must not be settable.

“Main”

Flag that indicates whether a window is the main window of an application. May be settable.

“Minimize Button”

Accessibility object that represents a window’s minimize button. Must not be settable.

“Minimized”

Flag that indicates whether a window is currently minimized in the Dock. May be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must be settable.

“Title”

Visible text title of an element. Must not be settable.

“Zoom Button”

Accessibility object representing the zoom button. Must not be settable.

Optional Attributes

“Cancel Button”

Accessibility object representing the window’s cancel button (if any). Must not be settable.

“Default Button”

Accessibility object representing the default button of a window or sheet. Must not be settable.

“Document”

URL or path for the document displayed in a window. Must not be settable.

“Full Screen Button”

Accessibility object representing the full-screen button of a window. Must not be settable.

“Grow Area”

Accessibility object representing the grow area element of a window or sheet. Must not be settable.

“Modal”

Flag that indicates whether the window represented by an element is modal. Must not be settable.

“Proxy”

Accessibility object representing a window’s document proxy element. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title UI Element”

UI element that represents another element’s static text title. Must not be settable.

“Toolbar Button”

Accessibility object representing the button that hides and reveals a window’s toolbar. Must not be settable.

Actions

“Raise”

Simulates bringing a window forward by clicking in its title bar.

Folder Dock Item

Subrole for a folder displayed in the Dock.

Pseudoclass: AXFolderDockItem

Cocoa constant: (none defined)

Carbon constant: kAXFolderDockItemSubrole (Available in OS X v10.4 and later.)

Subrole of “Dock Item.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Selected”

Flag that indicates whether a UI element is selected. May be settable.

“Shown Menu UI Element”

Accessibility object representing the Dock item’s Dock menu. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“URL”

URL or path associated with an element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

“Show Menu”

Simulates showing a menu by clicking it.

Full Screen Button

Subrole for the full-screen button of a window.

Pseudoclass: AXFullScreenButton

Cocoa constant: NSAccessibilityFullScreenButtonSubrole (Available in OS X v10.7 and later.)

Carbon constant: kAXFullScreenButtonSubrole (Available in OS X v10.7 and later.)

Subrole of “Button.”

Required Attributes

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

Increment Arrow

Subrole for the button representing the increment arrow (the up arrow in a scroll bar).

Pseudoclass: AXIncrementArrow

Cocoa constant: NSAccessibilityIncrementArrowSubrole (Available in OS X v10.3 and later.)

Carbon constant: kAXIncrementArrowSubrole (Available in OS X v10.3 and later.)

Subrole of “Button.”

Required Attributes

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

Increment Page

Subrole for the button representing the increment-page area of the scroll track in a scroll bar.

Pseudoclass: AXIncrementPage

Cocoa constant: NSAccessibilityIncrementPageSubrole (Available in OS X v10.3 and later.)

Carbon constant: kAXIncrementPageSubrole (Available in OS X v10.3 and later.)

Subrole of “Button.”

Required Attributes

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

Minimize Button

Subrole for a window’s minimize button.

Pseudoclass: AXMinimizeButton

Cocoa constant: NSAccessibilityMinimizeButtonSubrole (Available in OS X v10.2 and later.)

Carbon constant: kAXMinimizeButtonSubrole (Available in OS X v10.2 and later.)

Subrole of “Button.”

Required Attributes

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

Minimized Window Dock Item

Subrole for a minimized window displayed in the Dock.

Pseudoclass: AXMinimizedWindowDockItem

Cocoa constant: (none defined)

Carbon constant: kAXMinimizedWindowDockItemSubrole (Available in OS X v10.4 and later.)

Subrole of “Dock Item.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Selected”

Flag that indicates whether a UI element is selected. May be settable.

“Shown Menu UI Element”

Accessibility object representing the Dock item’s Dock menu. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

“Show Menu”

Simulates showing a menu by clicking it.

Outline Row

Role for an outline row.

Pseudoclass: AXOutlineRow

Cocoa constant: NSAccessibilityOutlineRowSubrole (Available in OS X v10.2 and later.)

Carbon constant: kAXOutlineRowSubrole (Available in OS X v10.2 and later.)

Subrole of “Row.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Disclosed By Row”

Row by which a row is disclosed. Must not be settable.

“Disclosed Rows”

Rows that are disclosed by this row. Must not be settable.

“Disclosing”

Flag that indicates whether a row is disclosing other rows. May be settable.

“Disclosure Level”

Depth of a row in a disclosure hierarchy. Must not be settable.

“Index”

Index of a row or column being represented. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Selected”

Flag that indicates whether a UI element is selected. May be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Visible Children”

Currently visible child elements of a UI element. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Process Switcher List

Subrole for the list of application icons that appears when the user presses Command-Tab.

Pseudoclass: AXProcessSwitcherList

Cocoa constant: (none defined)

Carbon constant: kAXProcessSwitcherListSubrole (Available in OS X v10.4 and later.)

Subrole of “List.”

Discussion

This subrole should be used for the system-provided UI element, not for any custom UI element.

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. May be settable.

“Orientation”

Horizontal or vertical orientation of an element—for example, a list, ruler, scroll bar, or splitter bar. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Selected Children”

Currently selected child elements of a UI element. May be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Visible Children”

Currently visible child elements of a UI element. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Rating Indicator

Subrole for a rating indicator.

Pseudoclass: AXRatingIndicator

Cocoa constant: NSAccessibilityRatingIndicatorSubrole (Available in OS X v10.6 and later.)

Carbon constant: kAXRatingIndicatorSubrole (Available in OS X v10.6 and later.)

Subrole of “Slider.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. May be settable.

“Max Value”

Maximum value that this element can display. Must not be settable.

“Min Value”

Minimum value that an element can display. Must not be settable.

“Orientation”

Horizontal or vertical orientation of an element—for example, a list, ruler, scroll bar, or splitter bar. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Value”

The element’s value. May be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Allowed Values”

Allowed values in a slider. Must not be settable.

“Help”

Help text for a UI element. Must not be settable.

Actions

“Decrement”

Decrements the value of an element to the next allowed value.

“Increment”

Increments the value of an element to the next allowed value.

Search Field

Subrole for a search field.

Pseudoclass: AXSearchField

Cocoa constant: NSAccessibilitySearchFieldSubrole (Available in OS X v10.3 and later.)

Carbon constant: kAXSearchFieldSubrole (Available in OS X v10.4 and later.)

Subrole of “Text Field.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Clear Button”

Accessibility object representing the clear button in a search field. Must not be settable.

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. May be settable.

“Number Of Characters”

Number of characters in an editable text field. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Search Button”

Accessibility object representing the search button in a search field. Must not be settable.

“Selected Text”

Currently selected text of a UI element. May be settable.

“Selected Text Range”

Position and length (in characters) of a selected portion of text in the UI element. May be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Value”

The element’s value. May be settable.

“Visible Character Range”

Range of characters that are scrolled into view in an editable text element. May be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Attributed String For Range”

Attributed string for the specified portion of the text associated with the currently selected item. Must not be settable.

“Bounds For Range”

Rectangle that bounds a range of text. Must not be settable.

“Help”

Help text for a UI element. Must not be settable.

“Insertion Point Line Number”

Number of the line that currently has the insertion point. Must not be settable.

“Line For Index”

The line number for the given text index. Must not be settable.

“Placeholder Value”

Placeholder value displayed when an element is empty. Must not be settable.

“Range For Index”

The full range of characters. Must not be settable.

“Range For Line”

The range of characters. Must not be settable.

“Range For Position”

The range of the composed character sequence at the given text index. Must not be settable.

“RTF For Range”

Rich Text Format (RTF) data for the range. Must not be settable.

“String For Range”

The substring. Must not be settable.

“Style Range For Index”

The full range of characters, which have the same style. Must not be settable.

Actions

“Confirm”

Simulates pressing Return in an element—for example, a text field.

Secure Text Field

Subrole for a secure text field.

Pseudoclass: AXSecureTextField

Cocoa constant: NSAccessibilitySecureTextFieldSubrole (Available in OS X v10.2 and later.)

Carbon constant: kAXSecureTextFieldSubrole (Available in OS X v10.2 and later.)

Subrole of “Text Field.”

Required Attributes

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. May be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Value”

The element’s value. May be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Help”

Help text for a UI element. Must not be settable.

“Placeholder Value”

Placeholder value displayed when an element is empty. Must not be settable.

“Value Description”

String that best describes the current value of an element. Must not be settable.

Actions

“Confirm”

Simulates pressing Return in an element—for example, a text field.

Separator Dock Item

Subrole for a separator displayed in the Dock.

Pseudoclass: AXSeparatorDockItem

Cocoa constant: (none defined)

Carbon constant: kAXSeparatorDockItemSubrole (Available in OS X v10.7 and later.)

Subrole of “Dock Item.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Description”

Localized, human-intelligible string that describes what a UI element does. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Shown Menu UI Element”

Accessibility object representing the Dock item’s Dock menu. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Value”

The element’s value. May be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

“Show Menu”

Simulates showing a menu by clicking it.

Sort Button

Subrole for a sort button.

Pseudoclass: AXSortButton

Cocoa constant: NSAccessibilitySortButtonSubrole (Available in OS X v10.6 and later.)

Carbon constant: kAXSortButtonSubrole (Available in OS X v10.4 and later.)

Subrole of “Button.”

Required Attributes

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Sort Direction”

Sort direction of a column. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

Standard Window

Subrole for a standard window.

Pseudoclass: AXStandardWindow

Cocoa constant: NSAccessibilityStandardWindowSubrole (Available in OS X v10.3 and later.)

Carbon constant: kAXStandardWindowSubrole (Available in OS X v10.3 and later.)

Subrole of “Window.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Close Button”

Accessibility object representing a window’s close button. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. Must not be settable.

“Main”

Flag that indicates whether a window is the main window of an application. May be settable.

“Minimize Button”

Accessibility object that represents a window’s minimize button. Must not be settable.

“Minimized”

Flag that indicates whether a window is currently minimized in the Dock. May be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must be settable.

“Title”

Visible text title of an element. Must not be settable.

“Zoom Button”

Accessibility object representing the zoom button. Must not be settable.

Optional Attributes

“Cancel Button”

Accessibility object representing the window’s cancel button (if any). Must not be settable.

“Default Button”

Accessibility object representing the default button of a window or sheet. Must not be settable.

“Document”

URL or path for the document displayed in a window. Must not be settable.

“Full Screen Button”

Accessibility object representing the full-screen button of a window. Must not be settable.

“Grow Area”

Accessibility object representing the grow area element of a window or sheet. Must not be settable.

“Modal”

Flag that indicates whether the window represented by an element is modal. Must not be settable.

“Proxy”

Accessibility object representing a window’s document proxy element. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title UI Element”

UI element that represents another element’s static text title. Must not be settable.

“Toolbar Button”

Accessibility object representing the button that hides and reveals a window’s toolbar. Must not be settable.

Actions

“Raise”

Simulates bringing a window forward by clicking in its title bar.

System Dialog

Subrole for a system dialog.

Pseudoclass: AXSystemDialog

Cocoa constant: NSAccessibilitySystemDialogSubrole (Available in OS X v10.3 and later.)

Carbon constant: kAXSystemDialogSubrole (Available in OS X v10.3 and later.)

Subrole of “Window.”

Discussion

A system-generated dialog floats on the top layer, regardless of which application is frontmost.

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Close Button”

Accessibility object representing a window’s close button. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. Must not be settable.

“Main”

Flag that indicates whether a window is the main window of an application. May be settable.

“Minimize Button”

Accessibility object that represents a window’s minimize button. Must not be settable.

“Minimized”

Flag that indicates whether a window is currently minimized in the Dock. May be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must be settable.

“Title”

Visible text title of an element. Must not be settable.

“Zoom Button”

Accessibility object representing the zoom button. Must not be settable.

Optional Attributes

“Cancel Button”

Accessibility object representing the window’s cancel button (if any). Must not be settable.

“Default Button”

Accessibility object representing the default button of a window or sheet. Must not be settable.

“Document”

URL or path for the document displayed in a window. Must not be settable.

“Full Screen Button”

Accessibility object representing the full-screen button of a window. Must not be settable.

“Grow Area”

Accessibility object representing the grow area element of a window or sheet. Must not be settable.

“Modal”

Flag that indicates whether the window represented by an element is modal. Must not be settable.

“Proxy”

Accessibility object representing a window’s document proxy element. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title UI Element”

UI element that represents another element’s static text title. Must not be settable.

“Toolbar Button”

Accessibility object representing the button that hides and reveals a window’s toolbar. Must not be settable.

Actions

“Raise”

Simulates bringing a window forward by clicking in its title bar.

System Floating Window

Subrole for a system-generated panel.

Pseudoclass: AXSystemFloatingWindow

Cocoa constant: NSAccessibilitySystemFloatingWindowSubrole (Available in OS X v10.3 and later.)

Carbon constant: kAXSystemFloatingWindowSubrole (Available in OS X v10.3 and later.)

Subrole of “Window.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Close Button”

Accessibility object representing a window’s close button. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. Must not be settable.

“Main”

Flag that indicates whether a window is the main window of an application. May be settable.

“Minimize Button”

Accessibility object that represents a window’s minimize button. Must not be settable.

“Minimized”

Flag that indicates whether a window is currently minimized in the Dock. May be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must be settable.

“Title”

Visible text title of an element. Must not be settable.

“Zoom Button”

Accessibility object representing the zoom button. Must not be settable.

Optional Attributes

“Cancel Button”

Accessibility object representing the window’s cancel button (if any). Must not be settable.

“Default Button”

Accessibility object representing the default button of a window or sheet. Must not be settable.

“Document”

URL or path for the document displayed in a window. Must not be settable.

“Full Screen Button”

Accessibility object representing the full-screen button of a window. Must not be settable.

“Grow Area”

Accessibility object representing the grow area element of a window or sheet. Must not be settable.

“Modal”

Flag that indicates whether the window represented by an element is modal. Must not be settable.

“Proxy”

Accessibility object representing a window’s document proxy element. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title UI Element”

UI element that represents another element’s static text title. Must not be settable.

“Toolbar Button”

Accessibility object representing the button that hides and reveals a window’s toolbar. Must not be settable.

Actions

“Raise”

Simulates bringing a window forward by clicking in its title bar.

Table Row

Role for a table row.

Pseudoclass: AXTableRow

Cocoa constant: NSAccessibilityTableRowSubrole (Available in OS X v10.2 and later.)

Carbon constant: kAXTableRowSubrole (Available in OS X v10.2 and later.)

Subrole of “Row.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Index”

Index of a row or column being represented. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Selected”

Flag that indicates whether a UI element is selected. May be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Visible Children”

Currently visible child elements of a UI element. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Text Attachment

Subrole for an image that represents an attachment.

Pseudoclass: AXTextAttachment

Cocoa constant: NSAccessibilityTextAttachmentSubrole (Available in OS X v10.4 and later.)

Carbon constant: (none defined)

Subrole of “Image.”

Required Attributes

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Description”

Localized, human-intelligible string that describes what a UI element does. Must not be settable.

“Filename”

Filename associated with an element. Must not be settable.

“Help”

Help text for a UI element. Must not be settable.

“URL”

URL or path associated with an element. Must not be settable.

Text Link

Subrole for a text link.

Pseudoclass: AXTextLink

Cocoa constant: NSAccessibilityTextLinkSubrole (Available in OS X v10.4 and later.)

Carbon constant: (none defined)

Subrole of “Link.”

Required Attributes

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“URL”

URL or path associated with an element. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

Timeline

Subrole for a media timeline.

Pseudoclass: AXTimeline

Cocoa constant: NSAccessibilityTimelineSubrole (Available in OS X v10.5 and later.)

Carbon constant: kAXTimelineSubrole (Available in OS X v10.5 and later.)

Subrole of “Slider.”

Discussion

A timeline can have multiple value indicators as its children, representing different markers on the timeline. For example, a video editing application could provide a marker for the current time, the in point, and the out point. If multiple value indicators are present, each one should have an accessibility description.

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. May be settable.

“Max Value”

Maximum value that this element can display. Must not be settable.

“Min Value”

Minimum value that an element can display. Must not be settable.

“Orientation”

Horizontal or vertical orientation of an element—for example, a list, ruler, scroll bar, or splitter bar. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Value”

The element’s value. May be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Allowed Values”

Allowed values in a slider. Must not be settable.

“Help”

Help text for a UI element. Must not be settable.

“Value Description”

String that best describes the current value of an element. Must not be settable.

Actions

“Decrement”

Decrements the value of an element to the next allowed value.

“Increment”

Increments the value of an element to the next allowed value.

Toolbar Button

Subrole for the button to hide and reveal the toolbar in a window.

Pseudoclass: AXToolbarButton

Cocoa constant: NSAccessibilityToolbarButtonSubrole (Available in OS X v10.2 and later.)

Carbon constant: kAXToolbarButtonSubrole (Available in OS X v10.2 and later.)

Subrole of “Button.”

Required Attributes

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

Trash Dock Item

Subrole for the trash.

Pseudoclass: AXTrashDockItem

Cocoa constant: (none defined)

Carbon constant: kAXTrashDockItemSubrole (Available in OS X v10.4 and later.)

Subrole of “Dock Item.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Selected”

Flag that indicates whether a UI element is selected. May be settable.

“Shown Menu UI Element”

Accessibility object representing the Dock item’s Dock menu. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

“Show Menu”

Simulates showing a menu by clicking it.

Unknown Subrole

Subrole for an unknown subrole.

Pseudoclass: AXUnknown

Cocoa constant: NSAccessibilityUnknownSubrole (Available in OS X v10.2 and later.)

Carbon constant: kAXUnknownSubrole (Available in OS X v10.2 and later.)

Subrole of “Unknown Object.”

Required Attributes

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

Optional Attributes

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

URL Dock Item

Subrole for a URL displayed in the Dock.

Pseudoclass: AXURLDockItem

Cocoa constant: (none defined)

Carbon constant: kAXURLDockItemSubrole (Available in OS X v10.4 and later.)

Subrole of “Dock Item.”

Required Attributes

“Children”

Child elements in an accessibility hierarchy. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Selected”

Flag that indicates whether a UI element is selected. May be settable.

“Shown Menu UI Element”

Accessibility object representing the Dock item’s Dock menu. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“URL”

URL or path associated with an element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.

“Show Menu”

Simulates showing a menu by clicking it.

Zoom Button

Subrole for a window’s zoom button.

Pseudoclass: AXZoomButton

Cocoa constant: NSAccessibilityZoomButtonSubrole (Available in OS X v10.2 and later.)

Carbon constant: kAXZoomButtonSubrole (Available in OS X v10.2 and later.)

Subrole of “Button.”

Required Attributes

“Enabled”

Flag that indicates whether a user can interact with a UI element. Must not be settable.

“Focused”

Flag that indicates whether an element has keyboard focus. Must not be settable.

“Parent”

Closest accessible container of a UI element. Must not be settable.

“Position”

Origin, in screen coordinates, of an element’s bounding rectangle. Must not be settable.

“Role”

Basic type of an element. Must not be settable.

“Role Description”

Localized, human-intelligible description of an element’s role. Must not be settable.

“Size”

Height and width of an element’s bounding rectangle, in screen coordinates. Must not be settable.

“Subrole”

Subtype or specialization of a role. Must not be settable.

“Title”

Visible text title of an element. Must not be settable.

“Top-Level UI Element”

A UI element’s containing window, sheet, or drawer. Must not be settable.

“Window”

Window containing the current element. Must not be settable.

Optional Attributes

“Help”

Help text for a UI element. Must not be settable.

Actions

“Press”

Simulates clicking an element—for example, a button.