Text Field Role
An accessibility object of the text field role includes the following attributes as shown in Table B-40:
Attribute | Required | Type | Description |
|---|---|---|---|
Parent | Yes | UIElement | Accessibility object representing the text field’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 text field’s containing window |
Top-Level UIElement | Yes | UIElement | Accessibility object representing the text field’s containing window, sheet, or drawer |
Help | No | String | Help-tag text for the text field |
Enabled | Yes | Boolean |
|
Focused | Yes | Boolean |
|
Value | Yes | String | Text in the text field |
Selected Text | Yes | String | Selected portion of the text in the text field |
Selected Text Range | Yes | Range value | Position and length (in characters) of the selected portion of the text in the text field |
Number of Characters | Yes | Number | Number of characters in the selected portion of the text in the text field |
Visible Character Range | Yes | Range value | Position and length (in characters) of the text in the text field |
Description | Yes | String | Human-intelligible description of the text field. 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 text field |
Insertion Point Line Number | No | Number | Line number of current cursor position in text field |
Subrole | No | String | Type of text field |
Search Button | No | UIElement | Accessibility object representing the search button. Required if the text field is a search field. |
Clear Button | No | UIElement | Accessibility object representing the clear button. Required if the text field is a search field. |
Note: A text field object also supports parameterized attributes. See the framework-specific documentation for more information on these attributes.
An accessibility object of the text field role can support the following action:
Confirm. When the confirm action is performed, the selected portion of the text in the text field can display an editing menu.
An accessibility object of the text field role can have the following subroles:
Search Field. The text field functions as a search field.
Secure Text Field. The text field can accept and obscure sensitive input, such as a password.
Last updated: 2008-03-11
  |
||
|
|
|
|
| ||
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 |