1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/accessible/public/nsIAccessibleRole.idl Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,781 @@
1.4 +/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
1.5 +/* This Source Code Form is subject to the terms of the Mozilla Public
1.6 + * License, v. 2.0. If a copy of the MPL was not distributed with this
1.7 + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
1.8 +
1.9 +#include "nsISupports.idl"
1.10 +
1.11 +/**
1.12 + * Defines cross platform (Gecko) roles.
1.13 + */
1.14 +[scriptable, uuid(50db5e86-9a45-4637-a5c3-4ff148c33270)]
1.15 +interface nsIAccessibleRole : nsISupports
1.16 +{
1.17 + /**
1.18 + * Used when accessible hans't strong defined role.
1.19 + */
1.20 + const unsigned long ROLE_NOTHING = 0;
1.21 +
1.22 + /**
1.23 + * Represents a title or caption bar for a window. It is used by MSAA only,
1.24 + * supported automatically by MS Windows.
1.25 + */
1.26 + const unsigned long ROLE_TITLEBAR = 1;
1.27 +
1.28 + /**
1.29 + * Represents the menu bar (positioned beneath the title bar of a window)
1.30 + * from which menus are selected by the user. The role is used by
1.31 + * xul:menubar or role="menubar".
1.32 + */
1.33 + const unsigned long ROLE_MENUBAR = 2;
1.34 +
1.35 + /**
1.36 + * Represents a vertical or horizontal scroll bar, which is part of the client
1.37 + * area or used in a control.
1.38 + */
1.39 + const unsigned long ROLE_SCROLLBAR = 3;
1.40 +
1.41 + /**
1.42 + * Represents a special mouse pointer, which allows a user to manipulate user
1.43 + * interface elements such as windows. For example, a user clicks and drags
1.44 + * a sizing grip in the lower-right corner of a window to resize it.
1.45 + */
1.46 + const unsigned long ROLE_GRIP = 4;
1.47 +
1.48 + /**
1.49 + * Represents a system sound, which is associated with various system events.
1.50 + */
1.51 + const unsigned long ROLE_SOUND = 5;
1.52 +
1.53 + /**
1.54 + * Represents the system mouse pointer.
1.55 + */
1.56 + const unsigned long ROLE_CURSOR = 6;
1.57 +
1.58 + /**
1.59 + * Represents the system caret. The role is supported for caret.
1.60 + */
1.61 + const unsigned long ROLE_CARET = 7;
1.62 +
1.63 + /**
1.64 + * Represents an alert or a condition that a user should be notified about.
1.65 + * Assistive Technologies typically respond to the role by reading the entire
1.66 + * onscreen contents of containers advertising this role. Should be used for
1.67 + * warning dialogs, etc. The role is used by xul:browsermessage,
1.68 + * role="alert".
1.69 + */
1.70 + const unsigned long ROLE_ALERT = 8;
1.71 +
1.72 + /**
1.73 + * Represents the window frame, which contains child objects such as
1.74 + * a title bar, client, and other objects contained in a window. The role
1.75 + * is supported automatically by MS Windows.
1.76 + */
1.77 + const unsigned long ROLE_WINDOW = 9;
1.78 +
1.79 + /**
1.80 + * A sub-document (<frame> or <iframe>)
1.81 + */
1.82 + const unsigned long ROLE_INTERNAL_FRAME = 10;
1.83 +
1.84 + /**
1.85 + * Represents a menu, which presents a list of options from which the user can
1.86 + * make a selection to perform an action. It is used for role="menu".
1.87 + */
1.88 + const unsigned long ROLE_MENUPOPUP = 11;
1.89 +
1.90 + /**
1.91 + * Represents a menu item, which is an entry in a menu that a user can choose
1.92 + * to carry out a command, select an option. It is used for xul:menuitem,
1.93 + * role="menuitem".
1.94 + */
1.95 + const unsigned long ROLE_MENUITEM = 12;
1.96 +
1.97 + /**
1.98 + * Represents a ToolTip that provides helpful hints.
1.99 + */
1.100 + const unsigned long ROLE_TOOLTIP = 13;
1.101 +
1.102 + /**
1.103 + * Represents a main window for an application. It is used for
1.104 + * role="application". Also refer to ROLE_APP_ROOT
1.105 + */
1.106 + const unsigned long ROLE_APPLICATION = 14;
1.107 +
1.108 + /**
1.109 + * Represents a document window. A document window is always contained within
1.110 + * an application window. It is used for role="document".
1.111 + */
1.112 + const unsigned long ROLE_DOCUMENT = 15;
1.113 +
1.114 + /**
1.115 + * Represents a pane within a frame or document window. Users can navigate
1.116 + * between panes and within the contents of the current pane, but cannot
1.117 + * navigate between items in different panes. Thus, panes represent a level
1.118 + * of grouping lower than frame windows or documents, but above individual
1.119 + * controls. It is used for the first child of a <frame> or <iframe>.
1.120 + */
1.121 + const unsigned long ROLE_PANE = 16;
1.122 +
1.123 + /**
1.124 + * Represents a graphical image used to represent data.
1.125 + */
1.126 + const unsigned long ROLE_CHART = 17;
1.127 +
1.128 + /**
1.129 + * Represents a dialog box or message box. It is used for xul:dialog,
1.130 + * role="dialog".
1.131 + */
1.132 + const unsigned long ROLE_DIALOG = 18;
1.133 +
1.134 + /**
1.135 + * Represents a window border.
1.136 + */
1.137 + const unsigned long ROLE_BORDER = 19;
1.138 +
1.139 + /**
1.140 + * Logically groups other objects. There is not always a parent-child
1.141 + * relationship between the grouping object and the objects it contains. It
1.142 + * is used for html:textfield, xul:groupbox, role="group".
1.143 + */
1.144 + const unsigned long ROLE_GROUPING = 20;
1.145 +
1.146 + /**
1.147 + * Used to visually divide a space into two regions, such as a separator menu
1.148 + * item or a bar that divides split panes within a window. It is used for
1.149 + * xul:separator, html:hr, role="separator".
1.150 + */
1.151 + const unsigned long ROLE_SEPARATOR = 21;
1.152 +
1.153 + /**
1.154 + * Represents a toolbar, which is a grouping of controls (push buttons or
1.155 + * toggle buttons) that provides easy access to frequently used features. It
1.156 + * is used for xul:toolbar, role="toolbar".
1.157 + */
1.158 + const unsigned long ROLE_TOOLBAR = 22;
1.159 +
1.160 + /**
1.161 + * Represents a status bar, which is an area at the bottom of a window that
1.162 + * displays information about the current operation, state of the application,
1.163 + * or selected object. The status bar has multiple fields, which display
1.164 + * different kinds of information. It is used for xul:statusbar.
1.165 + */
1.166 + const unsigned long ROLE_STATUSBAR = 23;
1.167 +
1.168 + /**
1.169 + * Represents a table that contains rows and columns of cells, and optionally,
1.170 + * row headers and column headers. It is used for html:table,
1.171 + * role="grid". Also refer to the following roles: ROLE_COLUMNHEADER,
1.172 + * ROLE_ROWHEADER, ROLE_COLUMN, ROLE_ROW, ROLE_CELL.
1.173 + */
1.174 + const unsigned long ROLE_TABLE = 24;
1.175 +
1.176 + /**
1.177 + * Represents a column header, providing a visual label for a column in
1.178 + * a table. It is used for XUL tree column headers, html:th,
1.179 + * role="colheader". Also refer to ROLE_TABLE.
1.180 + */
1.181 + const unsigned long ROLE_COLUMNHEADER = 25;
1.182 +
1.183 + /**
1.184 + * Represents a row header, which provides a visual label for a table row.
1.185 + * It is used for role="rowheader". Also, see ROLE_TABLE.
1.186 + */
1.187 + const unsigned long ROLE_ROWHEADER = 26;
1.188 +
1.189 + /**
1.190 + * Represents a column of cells within a table. Also, see ROLE_TABLE.
1.191 + */
1.192 + const unsigned long ROLE_COLUMN = 27;
1.193 +
1.194 + /**
1.195 + * Represents a row of cells within a table. Also, see ROLE_TABLE.
1.196 + */
1.197 + const unsigned long ROLE_ROW = 28;
1.198 +
1.199 + /**
1.200 + * Represents a cell within a table. It is used for html:td,
1.201 + * xul:tree cell and xul:listcell. Also, see ROLE_TABLE.
1.202 + */
1.203 + const unsigned long ROLE_CELL = 29;
1.204 +
1.205 + /**
1.206 + * Represents a link to something else. This object might look like text or
1.207 + * a graphic, but it acts like a button. It is used for
1.208 + * xul:label@class="text-link", html:a, html:area.
1.209 + */
1.210 + const unsigned long ROLE_LINK = 30;
1.211 +
1.212 + /**
1.213 + * Displays a Help topic in the form of a ToolTip or Help balloon.
1.214 + */
1.215 + const unsigned long ROLE_HELPBALLOON = 31;
1.216 +
1.217 + /**
1.218 + * Represents a cartoon-like graphic object, such as Microsoft Office
1.219 + * Assistant, which is displayed to provide help to users of an application.
1.220 + */
1.221 + const unsigned long ROLE_CHARACTER = 32;
1.222 +
1.223 + /**
1.224 + * Represents a list box, allowing the user to select one or more items. It
1.225 + * is used for xul:listbox, html:select@size, role="list". See also
1.226 + * ROLE_LIST_ITEM.
1.227 + */
1.228 + const unsigned long ROLE_LIST = 33;
1.229 +
1.230 + /**
1.231 + * Represents an item in a list. See also ROLE_LIST.
1.232 + */
1.233 + const unsigned long ROLE_LISTITEM = 34;
1.234 +
1.235 + /**
1.236 + * Represents an outline or tree structure, such as a tree view control,
1.237 + * that displays a hierarchical list and allows the user to expand and
1.238 + * collapse branches. Is is used for role="tree".
1.239 + */
1.240 + const unsigned long ROLE_OUTLINE = 35;
1.241 +
1.242 + /**
1.243 + * Represents an item in an outline or tree structure. It is used for
1.244 + * role="treeitem".
1.245 + */
1.246 + const unsigned long ROLE_OUTLINEITEM = 36;
1.247 +
1.248 + /**
1.249 + * Represents a page tab, it is a child of a page tab list. It is used for
1.250 + * xul:tab, role="treeitem". Also refer to ROLE_PAGETABLIST.
1.251 + */
1.252 + const unsigned long ROLE_PAGETAB = 37;
1.253 +
1.254 + /**
1.255 + * Represents a property sheet. It is used for xul:tabpanel,
1.256 + * role="tabpanel".
1.257 + */
1.258 + const unsigned long ROLE_PROPERTYPAGE = 38;
1.259 +
1.260 + /**
1.261 + * Represents an indicator, such as a pointer graphic, that points to the
1.262 + * current item.
1.263 + */
1.264 + const unsigned long ROLE_INDICATOR = 39;
1.265 +
1.266 + /**
1.267 + * Represents a picture. Is is used for xul:image, html:img.
1.268 + */
1.269 + const unsigned long ROLE_GRAPHIC = 40;
1.270 +
1.271 + /**
1.272 + * Represents read-only text, such as labels for other controls or
1.273 + * instructions in a dialog box. Static text cannot be modified or selected.
1.274 + * Is is used for xul:label, xul:description, html:label, role="label".
1.275 + */
1.276 + const unsigned long ROLE_STATICTEXT = 41;
1.277 +
1.278 + /**
1.279 + * Represents selectable text that allows edits or is designated read-only.
1.280 + */
1.281 + const unsigned long ROLE_TEXT_LEAF = 42;
1.282 +
1.283 + /**
1.284 + * Represents a push button control. It is used for xul:button, html:button,
1.285 + * role="button".
1.286 + */
1.287 + const unsigned long ROLE_PUSHBUTTON = 43;
1.288 +
1.289 + /**
1.290 + * Represents a check box control. It is used for xul:checkbox,
1.291 + * html:input@type="checkbox", role="checkbox".
1.292 + */
1.293 + const unsigned long ROLE_CHECKBUTTON = 44;
1.294 +
1.295 + /**
1.296 + * Represents an option button, also called a radio button. It is one of a
1.297 + * group of mutually exclusive options. All objects sharing a single parent
1.298 + * that have this attribute are assumed to be part of single mutually
1.299 + * exclusive group. It is used for xul:radio, html:input@type="radio",
1.300 + * role="radio".
1.301 + */
1.302 + const unsigned long ROLE_RADIOBUTTON = 45;
1.303 +
1.304 + /**
1.305 + * Represents a combo box; an edit control with an associated list box that
1.306 + * provides a set of predefined choices. It is used for html:select,
1.307 + * xul:menulist, role="combobox".
1.308 + */
1.309 + const unsigned long ROLE_COMBOBOX = 46;
1.310 +
1.311 + /**
1.312 + * Represents the calendar control.
1.313 + */
1.314 + const unsigned long ROLE_DROPLIST = 47;
1.315 +
1.316 + /**
1.317 + * Represents a progress bar, dynamically showing the user the percent
1.318 + * complete of an operation in progress. It is used for xul:progressmeter,
1.319 + * role="progressbar".
1.320 + */
1.321 + const unsigned long ROLE_PROGRESSBAR = 48;
1.322 +
1.323 + /**
1.324 + * Represents a dial or knob whose purpose is to allow a user to set a value.
1.325 + */
1.326 + const unsigned long ROLE_DIAL = 49;
1.327 +
1.328 + /**
1.329 + * Represents a hot-key field that allows the user to enter a combination or
1.330 + * sequence of keystrokes.
1.331 + */
1.332 + const unsigned long ROLE_HOTKEYFIELD = 50;
1.333 +
1.334 + /**
1.335 + * Represents a slider, which allows the user to adjust a setting in given
1.336 + * increments between minimum and maximum values. It is used by xul:scale,
1.337 + * role="slider".
1.338 + */
1.339 + const unsigned long ROLE_SLIDER = 51;
1.340 +
1.341 + /**
1.342 + * Represents a spin box, which is a control that allows the user to increment
1.343 + * or decrement the value displayed in a separate "buddy" control associated
1.344 + * with the spin box. It is used for xul:spinbuttons.
1.345 + */
1.346 + const unsigned long ROLE_SPINBUTTON = 52;
1.347 +
1.348 + /**
1.349 + * Represents a graphical image used to diagram data. It is used for svg:svg.
1.350 + */
1.351 + const unsigned long ROLE_DIAGRAM = 53;
1.352 +
1.353 + /**
1.354 + * Represents an animation control, which contains content that changes over
1.355 + * time, such as a control that displays a series of bitmap frames.
1.356 + */
1.357 + const unsigned long ROLE_ANIMATION = 54;
1.358 +
1.359 + /**
1.360 + * Represents a mathematical equation. It is used by MATHML, where there is a
1.361 + * rich DOM subtree for an equation. Use ROLE_FLAT_EQUATION for <img role="math" alt="[TeX]"/>
1.362 + */
1.363 + const unsigned long ROLE_EQUATION = 55;
1.364 +
1.365 + /**
1.366 + * Represents a button that drops down a list of items.
1.367 + */
1.368 + const unsigned long ROLE_BUTTONDROPDOWN = 56;
1.369 +
1.370 + /**
1.371 + * Represents a button that drops down a menu.
1.372 + */
1.373 + const unsigned long ROLE_BUTTONMENU = 57;
1.374 +
1.375 + /**
1.376 + * Represents a button that drops down a grid. It is used for xul:colorpicker.
1.377 + */
1.378 + const unsigned long ROLE_BUTTONDROPDOWNGRID = 58;
1.379 +
1.380 + /**
1.381 + * Represents blank space between other objects.
1.382 + */
1.383 + const unsigned long ROLE_WHITESPACE = 59;
1.384 +
1.385 + /**
1.386 + * Represents a container of page tab controls. Is it used for xul:tabs,
1.387 + * DHTML: role="tabs". Also refer to ROLE_PAGETAB.
1.388 + */
1.389 + const unsigned long ROLE_PAGETABLIST = 60;
1.390 +
1.391 + /**
1.392 + * Represents a control that displays time.
1.393 + */
1.394 + const unsigned long ROLE_CLOCK = 61;
1.395 +
1.396 + /**
1.397 + * Represents a button on a toolbar that has a drop-down list icon directly
1.398 + * adjacent to the button.
1.399 + */
1.400 + const unsigned long ROLE_SPLITBUTTON = 62;
1.401 +
1.402 + /**
1.403 + * Represents an edit control designed for an Internet Protocol (IP) address.
1.404 + * The edit control is divided into sections for the different parts of the
1.405 + * IP address.
1.406 + */
1.407 + const unsigned long ROLE_IPADDRESS = 63;
1.408 +
1.409 + /**
1.410 + * Represents a label control that has an accelerator.
1.411 + */
1.412 + const unsigned long ROLE_ACCEL_LABEL = 64;
1.413 +
1.414 + /**
1.415 + * Represents an arrow in one of the four cardinal directions.
1.416 + */
1.417 + const unsigned long ROLE_ARROW = 65;
1.418 +
1.419 + /**
1.420 + * Represents a control that can be drawn into and is used to trap events.
1.421 + * It is used for html:canvas.
1.422 + */
1.423 + const unsigned long ROLE_CANVAS = 66;
1.424 +
1.425 + /**
1.426 + * Represents a menu item with a check box.
1.427 + */
1.428 + const unsigned long ROLE_CHECK_MENU_ITEM = 67;
1.429 +
1.430 + /**
1.431 + * Represents a specialized dialog that lets the user choose a color.
1.432 + */
1.433 + const unsigned long ROLE_COLOR_CHOOSER = 68;
1.434 +
1.435 + /**
1.436 + * Represents control whose purpose is to allow a user to edit a date.
1.437 + */
1.438 + const unsigned long ROLE_DATE_EDITOR = 69;
1.439 +
1.440 + /**
1.441 + * An iconified internal frame in an ROLE_DESKTOP_PANE. Also refer to
1.442 + * ROLE_INTERNAL_FRAME.
1.443 + */
1.444 + const unsigned long ROLE_DESKTOP_ICON = 70;
1.445 +
1.446 + /**
1.447 + * A desktop pane. A pane that supports internal frames and iconified
1.448 + * versions of those internal frames.
1.449 + */
1.450 + const unsigned long ROLE_DESKTOP_FRAME = 71;
1.451 +
1.452 + /**
1.453 + * A directory pane. A pane that allows the user to navigate through
1.454 + * and select the contents of a directory. May be used by a file chooser.
1.455 + * Also refer to ROLE_FILE_CHOOSER.
1.456 + */
1.457 + const unsigned long ROLE_DIRECTORY_PANE = 72;
1.458 +
1.459 + /**
1.460 + * A file chooser. A specialized dialog that displays the files in the
1.461 + * directory and lets the user select a file, browse a different directory,
1.462 + * or specify a filename. May use the directory pane to show the contents of
1.463 + * a directory. Also refer to ROLE_DIRECTORY_PANE.
1.464 + */
1.465 + const unsigned long ROLE_FILE_CHOOSER = 73;
1.466 +
1.467 + /**
1.468 + * A font chooser. A font chooser is a component that lets the user pick
1.469 + * various attributes for fonts.
1.470 + */
1.471 + const unsigned long ROLE_FONT_CHOOSER = 74;
1.472 +
1.473 + /**
1.474 + * Frame role. A top level window with a title bar, border, menu bar, etc.
1.475 + * It is often used as the primary window for an application.
1.476 + */
1.477 + const unsigned long ROLE_CHROME_WINDOW = 75;
1.478 +
1.479 + /**
1.480 + * A glass pane. A pane that is guaranteed to be painted on top of all
1.481 + * panes beneath it. Also refer to ROLE_ROOT_PANE.
1.482 + */
1.483 + const unsigned long ROLE_GLASS_PANE = 76;
1.484 +
1.485 + /**
1.486 + * A document container for HTML, whose children represent the document
1.487 + * content.
1.488 + */
1.489 + const unsigned long ROLE_HTML_CONTAINER = 77;
1.490 +
1.491 + /**
1.492 + * A small fixed size picture, typically used to decorate components.
1.493 + */
1.494 + const unsigned long ROLE_ICON = 78;
1.495 +
1.496 + /**
1.497 + * Presents an icon or short string in an interface.
1.498 + */
1.499 + const unsigned long ROLE_LABEL = 79;
1.500 +
1.501 + /**
1.502 + * A layered pane. A specialized pane that allows its children to be drawn
1.503 + * in layers, providing a form of stacking order. This is usually the pane
1.504 + * that holds the menu bar as well as the pane that contains most of the
1.505 + * visual components in a window. Also refer to ROLE_GLASS_PANE and
1.506 + * ROLE_ROOT_PANE.
1.507 + */
1.508 + const unsigned long ROLE_LAYERED_PANE = 80;
1.509 +
1.510 + /**
1.511 + * A specialized pane whose primary use is inside a dialog.
1.512 + */
1.513 + const unsigned long ROLE_OPTION_PANE = 81;
1.514 +
1.515 + /**
1.516 + * A text object uses for passwords, or other places where the text content
1.517 + * is not shown visibly to the user.
1.518 + */
1.519 + const unsigned long ROLE_PASSWORD_TEXT = 82;
1.520 +
1.521 + /**
1.522 + * A temporary window that is usually used to offer the user a list of
1.523 + * choices, and then hides when the user selects one of those choices.
1.524 + */
1.525 + const unsigned long ROLE_POPUP_MENU = 83;
1.526 +
1.527 + /**
1.528 + * A radio button that is a menu item.
1.529 + */
1.530 + const unsigned long ROLE_RADIO_MENU_ITEM = 84;
1.531 +
1.532 + /**
1.533 + * A root pane. A specialized pane that has a glass pane and a layered pane
1.534 + * as its children. Also refer to ROLE_GLASS_PANE and ROLE_LAYERED_PANE.
1.535 + */
1.536 + const unsigned long ROLE_ROOT_PANE = 85;
1.537 +
1.538 + /**
1.539 + * A scroll pane. An object that allows a user to incrementally view a large
1.540 + * amount of information. Its children can include scroll bars and a
1.541 + * viewport. Also refer to ROLE_VIEW_PORT.
1.542 + */
1.543 + const unsigned long ROLE_SCROLL_PANE = 86;
1.544 +
1.545 + /**
1.546 + * A split pane. A specialized panel that presents two other panels at the
1.547 + * same time. Between the two panels is a divider the user can manipulate to
1.548 + * make one panel larger and the other panel smaller.
1.549 + */
1.550 + const unsigned long ROLE_SPLIT_PANE = 87;
1.551 +
1.552 + /**
1.553 + * The header for a column of a table.
1.554 + * XXX: it looks this role is dupe of ROLE_COLUMNHEADER.
1.555 + */
1.556 + const unsigned long ROLE_TABLE_COLUMN_HEADER = 88;
1.557 +
1.558 + /**
1.559 + * The header for a row of a table.
1.560 + * XXX: it looks this role is dupe of ROLE_ROWHEADER
1.561 + */
1.562 + const unsigned long ROLE_TABLE_ROW_HEADER = 89;
1.563 +
1.564 + /**
1.565 + * A menu item used to tear off and reattach its menu.
1.566 + */
1.567 + const unsigned long ROLE_TEAR_OFF_MENU_ITEM = 90;
1.568 +
1.569 + /**
1.570 + * Represents an accessible terminal.
1.571 + */
1.572 + const unsigned long ROLE_TERMINAL = 91;
1.573 +
1.574 + /**
1.575 + * Collection of objects that constitute a logical text entity.
1.576 + */
1.577 + const unsigned long ROLE_TEXT_CONTAINER = 92;
1.578 +
1.579 + /**
1.580 + * A toggle button. A specialized push button that can be checked or
1.581 + * unchecked, but does not provide a separate indicator for the current state.
1.582 + */
1.583 + const unsigned long ROLE_TOGGLE_BUTTON = 93;
1.584 +
1.585 + /**
1.586 + * Representas a control that is capable of expanding and collapsing rows as
1.587 + * well as showing multiple columns of data.
1.588 + * XXX: it looks like this role is dupe of ROLE_OUTLINE.
1.589 + */
1.590 + const unsigned long ROLE_TREE_TABLE = 94;
1.591 +
1.592 + /**
1.593 + * A viewport. An object usually used in a scroll pane. It represents the
1.594 + * portion of the entire data that the user can see. As the user manipulates
1.595 + * the scroll bars, the contents of the viewport can change. Also refer to
1.596 + * ROLE_SCROLL_PANE.
1.597 + */
1.598 + const unsigned long ROLE_VIEWPORT = 95;
1.599 +
1.600 + /**
1.601 + * Header of a document page. Also refer to ROLE_FOOTER.
1.602 + */
1.603 + const unsigned long ROLE_HEADER = 96;
1.604 +
1.605 + /**
1.606 + * Footer of a document page. Also refer to ROLE_HEADER.
1.607 + */
1.608 + const unsigned long ROLE_FOOTER = 97;
1.609 +
1.610 + /**
1.611 + * A paragraph of text.
1.612 + */
1.613 + const unsigned long ROLE_PARAGRAPH = 98;
1.614 +
1.615 + /**
1.616 + * A ruler such as those used in word processors.
1.617 + */
1.618 + const unsigned long ROLE_RULER = 99;
1.619 +
1.620 + /**
1.621 + * A text entry having dialog or list containing items for insertion into
1.622 + * an entry widget, for instance a list of words for completion of a
1.623 + * text entry. It is used for xul:textbox@autocomplete
1.624 + */
1.625 + const unsigned long ROLE_AUTOCOMPLETE = 100;
1.626 +
1.627 + /**
1.628 + * An editable text object in a toolbar.
1.629 + */
1.630 + const unsigned long ROLE_EDITBAR = 101;
1.631 +
1.632 + /**
1.633 + * An control whose textual content may be entered or modified by the user.
1.634 + */
1.635 + const unsigned long ROLE_ENTRY = 102;
1.636 +
1.637 + /**
1.638 + * A caption describing another object.
1.639 + */
1.640 + const unsigned long ROLE_CAPTION = 103;
1.641 +
1.642 + /**
1.643 + * A visual frame or container which contains a view of document content.
1.644 + * Document frames may occur within another Document instance, in which case
1.645 + * the second document may be said to be embedded in the containing instance.
1.646 + * HTML frames are often ROLE_DOCUMENT_FRAME. Either this object, or a
1.647 + * singleton descendant, should implement the Document interface.
1.648 + */
1.649 + const unsigned long ROLE_DOCUMENT_FRAME = 104;
1.650 +
1.651 + /**
1.652 + * Heading.
1.653 + */
1.654 + const unsigned long ROLE_HEADING = 105;
1.655 +
1.656 + /**
1.657 + * An object representing a page of document content. It is used in documents
1.658 + * which are accessed by the user on a page by page basis.
1.659 + */
1.660 + const unsigned long ROLE_PAGE = 106;
1.661 +
1.662 + /**
1.663 + * A container of document content. An example of the use of this role is to
1.664 + * represent an html:div.
1.665 + */
1.666 + const unsigned long ROLE_SECTION = 107;
1.667 +
1.668 + /**
1.669 + * An object which is redundant with another object in the accessible
1.670 + * hierarchy. ATs typically ignore objects with this role.
1.671 + */
1.672 + const unsigned long ROLE_REDUNDANT_OBJECT = 108;
1.673 +
1.674 + /**
1.675 + * A container of form controls. An example of the use of this role is to
1.676 + * represent an html:form.
1.677 + */
1.678 + const unsigned long ROLE_FORM = 109;
1.679 +
1.680 + /**
1.681 + * An object which is used to allow input of characters not found on a
1.682 + * keyboard, such as the input of Chinese characters on a Western keyboard.
1.683 + */
1.684 + const unsigned long ROLE_IME = 110;
1.685 +
1.686 + /**
1.687 + * XXX: document this.
1.688 + */
1.689 + const unsigned long ROLE_APP_ROOT = 111;
1.690 +
1.691 + /**
1.692 + * Represents a menu item, which is an entry in a menu that a user can choose
1.693 + * to display another menu.
1.694 + */
1.695 + const unsigned long ROLE_PARENT_MENUITEM = 112;
1.696 +
1.697 + /**
1.698 + * A calendar that allows the user to select a date.
1.699 + */
1.700 + const unsigned long ROLE_CALENDAR = 113;
1.701 +
1.702 + /**
1.703 + * A list of items that is shown by combobox.
1.704 + */
1.705 + const unsigned long ROLE_COMBOBOX_LIST = 114;
1.706 +
1.707 + /**
1.708 + * A item of list that is shown by combobox;
1.709 + */
1.710 + const unsigned long ROLE_COMBOBOX_OPTION = 115;
1.711 +
1.712 + /**
1.713 + * An image map -- has child links representing the areas
1.714 + */
1.715 + const unsigned long ROLE_IMAGE_MAP = 116;
1.716 +
1.717 + /**
1.718 + * An option in a listbox
1.719 + */
1.720 + const unsigned long ROLE_OPTION = 117;
1.721 +
1.722 + /**
1.723 + * A rich option in a listbox, it can have other widgets as children
1.724 + */
1.725 + const unsigned long ROLE_RICH_OPTION = 118;
1.726 +
1.727 + /**
1.728 + * A list of options
1.729 + */
1.730 + const unsigned long ROLE_LISTBOX = 119;
1.731 +
1.732 + /**
1.733 + * Represents a mathematical equation in the accessible name
1.734 + */
1.735 + const unsigned long ROLE_FLAT_EQUATION = 120;
1.736 +
1.737 + /**
1.738 + * Represents a cell within a grid. It is used for role="gridcell". Unlike
1.739 + * ROLE_CELL, it allows the calculation of the accessible name from subtree.
1.740 + * Also, see ROLE_TABLE.
1.741 + */
1.742 + const unsigned long ROLE_GRID_CELL = 121;
1.743 +
1.744 + /**
1.745 + * Represents an embedded object. It is used for html:object or html:embed.
1.746 + */
1.747 + const unsigned long ROLE_EMBEDDED_OBJECT = 122;
1.748 +
1.749 + /**
1.750 + * A note. Originally intended to be hidden until activated, but now also used
1.751 + * for things like html 'aside'.
1.752 + */
1.753 + const unsigned long ROLE_NOTE = 123;
1.754 +
1.755 + /**
1.756 + * A figure. Used for things like HTML5 figure element.
1.757 + */
1.758 + const unsigned long ROLE_FIGURE = 124;
1.759 +
1.760 + /**
1.761 + * Represents a rich item with a check box.
1.762 + */
1.763 + const unsigned long ROLE_CHECK_RICH_OPTION = 125;
1.764 +
1.765 + /**
1.766 + * An HTML definition list <dl>
1.767 + */
1.768 + const unsigned long ROLE_DEFINITION_LIST = 126;
1.769 +
1.770 + /**
1.771 + * An HTML definition term <dt>
1.772 + */
1.773 + const unsigned long ROLE_TERM = 127;
1.774 +
1.775 + /**
1.776 + * An HTML definition <dd>
1.777 + */
1.778 + const unsigned long ROLE_DEFINITION = 128;
1.779 +
1.780 + /**
1.781 + * A keyboard or keypad key.
1.782 + */
1.783 + const unsigned long ROLE_KEY = 129;
1.784 +};
