michael@0: /* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
michael@0: /* vim: set ts=2 et sw=2 tw=80: */
michael@0: /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0:  * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0:  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0: 
michael@0: #ifndef _role_h_
michael@0: #define _role_h_
michael@0: 
michael@0: /**
michael@0:  * @note Make sure to update the localized role names when changing the list.
michael@0:  * @note When adding a new role, be sure to also add it to base/RoleMap.h and
michael@0:  *       update nsIAccessibleRole.
michael@0:  */
michael@0: 
michael@0: namespace mozilla {
michael@0: namespace a11y {
michael@0: namespace roles {
michael@0: 
michael@0: enum Role {
michael@0:   /**
michael@0:    * Used when accessible hans't strong defined role.
michael@0:    */
michael@0:   NOTHING = 0,
michael@0: 
michael@0:   /**
michael@0:    * Represents a title or caption bar for a window. It is used by MSAA only,
michael@0:    * supported automatically by MS Windows.
michael@0:    */
michael@0:   TITLEBAR = 1,
michael@0: 
michael@0:   /**
michael@0:    * Represents the menu bar (positioned beneath the title bar of a window)
michael@0:    * from which menus are selected by the user. The role is used by
michael@0:    * xul:menubar or role="menubar".
michael@0:    */
michael@0:   MENUBAR = 2,
michael@0: 
michael@0:   /**
michael@0:    * Represents a vertical or horizontal scroll bar, which is part of the client
michael@0:    * area or used in a control.
michael@0:    */
michael@0:   SCROLLBAR = 3,
michael@0: 
michael@0:   /**
michael@0:    * Represents a special mouse pointer, which allows a user to manipulate user
michael@0:    * interface elements such as windows. For example, a user clicks and drags
michael@0:    * a sizing grip in the lower-right corner of a window to resize it.
michael@0:    */
michael@0:   GRIP = 4,
michael@0: 
michael@0:   /**
michael@0:    * Represents a system sound, which is associated with various system events.
michael@0:    */
michael@0:   SOUND = 5,
michael@0: 
michael@0:   /**
michael@0:    * Represents the system mouse pointer.
michael@0:    */
michael@0:   CURSOR = 6,
michael@0: 
michael@0:   /**
michael@0:    * Represents the system caret. The role is supported for caret.
michael@0:    */
michael@0:   CARET = 7,
michael@0: 
michael@0:   /**
michael@0:    * Represents an alert or a condition that a user should be notified about.
michael@0:    * Assistive Technologies typically respond to the role by reading the entire
michael@0:    * onscreen contents of containers advertising this role. Should be used for
michael@0:    * warning dialogs, etc. The role is used by xul:browsermessage,
michael@0:    * role="alert".
michael@0:    */
michael@0:   ALERT = 8,
michael@0: 
michael@0:   /**
michael@0:    * Represents the window frame, which contains child objects such as
michael@0:    * a title bar, client, and other objects contained in a window. The role
michael@0:    * is supported automatically by MS Windows.
michael@0:    */
michael@0:   WINDOW = 9,
michael@0: 
michael@0:   /**
michael@0:    * A sub-document (<frame> or <iframe>)
michael@0:    */
michael@0:   INTERNAL_FRAME = 10,
michael@0: 
michael@0:   /**
michael@0:    * Represents a menu, which presents a list of options from which the user can
michael@0:    * make a selection to perform an action. It is used for role="menu".
michael@0:    */
michael@0:   MENUPOPUP = 11,
michael@0: 
michael@0:   /**
michael@0:    * Represents a menu item, which is an entry in a menu that a user can choose
michael@0:    * to carry out a command, select an option. It is used for xul:menuitem,
michael@0:    * role="menuitem".
michael@0:    */
michael@0:   MENUITEM = 12,
michael@0: 
michael@0:   /**
michael@0:    * Represents a ToolTip that provides helpful hints.
michael@0:    */
michael@0:   TOOLTIP = 13,
michael@0: 
michael@0:   /**
michael@0:    * Represents a main window for an application. It is used for
michael@0:    * role="application". Also refer to APP_ROOT
michael@0:    */
michael@0:   APPLICATION = 14,
michael@0: 
michael@0:   /**
michael@0:    * Represents a document window. A document window is always contained within
michael@0:    * an application window. It is used for role="document".
michael@0:    */
michael@0:   DOCUMENT = 15,
michael@0: 
michael@0:   /**
michael@0:    * Represents a pane within a frame or document window. Users can navigate
michael@0:    * between panes and within the contents of the current pane, but cannot
michael@0:    * navigate between items in different panes. Thus, panes represent a level
michael@0:    * of grouping lower than frame windows or documents, but above individual
michael@0:    * controls. It is used for the first child of a <frame> or <iframe>.
michael@0:    */
michael@0:   PANE = 16,
michael@0: 
michael@0:   /**
michael@0:    * Represents a graphical image used to represent data.
michael@0:    */
michael@0:   CHART = 17,
michael@0: 
michael@0:   /**
michael@0:    * Represents a dialog box or message box. It is used for xul:dialog, 
michael@0:    * role="dialog".
michael@0:    */
michael@0:   DIALOG = 18,
michael@0: 
michael@0:   /**
michael@0:    * Represents a window border.
michael@0:    */
michael@0:   BORDER = 19,
michael@0: 
michael@0:   /**
michael@0:    * Logically groups other objects. There is not always a parent-child
michael@0:    * relationship between the grouping object and the objects it contains. It
michael@0:    * is used for html:textfield, xul:groupbox, role="group".
michael@0:    */
michael@0:   GROUPING = 20,
michael@0: 
michael@0:   /**
michael@0:    * Used to visually divide a space into two regions, such as a separator menu
michael@0:    * item or a bar that divides split panes within a window. It is used for
michael@0:    * xul:separator, html:hr, role="separator".
michael@0:    */
michael@0:   SEPARATOR = 21,
michael@0: 
michael@0:   /**
michael@0:    * Represents a toolbar, which is a grouping of controls (push buttons or
michael@0:    * toggle buttons) that provides easy access to frequently used features. It
michael@0:    * is used for xul:toolbar, role="toolbar".
michael@0:    */
michael@0:   TOOLBAR = 22,
michael@0: 
michael@0:   /**
michael@0:    * Represents a status bar, which is an area at the bottom of a window that
michael@0:    * displays information about the current operation, state of the application,
michael@0:    * or selected object. The status bar has multiple fields, which display
michael@0:    * different kinds of information. It is used for xul:statusbar.
michael@0:    */
michael@0:   STATUSBAR = 23,
michael@0: 
michael@0:   /**
michael@0:    * Represents a table that contains rows and columns of cells, and optionally,
michael@0:    * row headers and column headers. It is used for html:table,
michael@0:    * role="grid". Also refer to the following role: COLUMNHEADER,
michael@0:    * ROWHEADER, COLUMN, ROW, CELL.
michael@0:    */
michael@0:   TABLE = 24,
michael@0: 
michael@0:   /**
michael@0:    * Represents a column header, providing a visual label for a column in
michael@0:    * a table. It is used for XUL tree column headers, html:th,
michael@0:    * role="colheader". Also refer to TABLE.
michael@0:    */
michael@0:   COLUMNHEADER = 25,
michael@0: 
michael@0:   /**
michael@0:    * Represents a row header, which provides a visual label for a table row.
michael@0:    * It is used for role="rowheader". Also, see TABLE.
michael@0:    */
michael@0:   ROWHEADER = 26,
michael@0: 
michael@0:   /**
michael@0:    * Represents a column of cells within a table. Also, see TABLE.
michael@0:    */
michael@0:   COLUMN = 27,
michael@0: 
michael@0:   /**
michael@0:    * Represents a row of cells within a table. Also, see TABLE.
michael@0:    */
michael@0:   ROW = 28,
michael@0: 
michael@0:   /**
michael@0:    * Represents a cell within a table. It is used for html:td,
michael@0:    * xul:tree cell and xul:listcell. Also, see TABLE.
michael@0:    */
michael@0:   CELL = 29,
michael@0: 
michael@0:   /**
michael@0:    * Represents a link to something else. This object might look like text or
michael@0:    * a graphic, but it acts like a button. It is used for
michael@0:    * xul:label@class="text-link", html:a, html:area.
michael@0:    */
michael@0:   LINK = 30,
michael@0: 
michael@0:   /**
michael@0:    * Displays a Help topic in the form of a ToolTip or Help balloon.
michael@0:    */
michael@0:   HELPBALLOON = 31,
michael@0: 
michael@0:   /**
michael@0:    * Represents a cartoon-like graphic object, such as Microsoft Office
michael@0:    * Assistant, which is displayed to provide help to users of an application.
michael@0:    */
michael@0:   CHARACTER = 32,
michael@0: 
michael@0:   /**
michael@0:    * Represents a list box, allowing the user to select one or more items. It
michael@0:    * is used for xul:listbox, html:select@size, role="list". See also
michael@0:    * LIST_ITEM.
michael@0:    */
michael@0:   LIST = 33,
michael@0: 
michael@0:   /**
michael@0:    * Represents an item in a list. See also LIST.
michael@0:    */
michael@0:   LISTITEM = 34,
michael@0: 
michael@0:   /**
michael@0:    * Represents an outline or tree structure, such as a tree view control,
michael@0:    * that displays a hierarchical list and allows the user to expand and
michael@0:    * collapse branches. Is is used for role="tree".
michael@0:    */
michael@0:   OUTLINE = 35,
michael@0: 
michael@0:   /**
michael@0:    * Represents an item in an outline or tree structure. It is used for
michael@0:    * role="treeitem".
michael@0:    */
michael@0:   OUTLINEITEM = 36,
michael@0: 
michael@0:   /**
michael@0:    * Represents a page tab, it is a child of a page tab list. It is used for
michael@0:    * xul:tab, role="treeitem". Also refer to PAGETABLIST.
michael@0:    */
michael@0:   PAGETAB = 37,
michael@0: 
michael@0:   /**
michael@0:    * Represents a property sheet. It is used for xul:tabpanel,
michael@0:    * role="tabpanel".
michael@0:    */
michael@0:   PROPERTYPAGE = 38,
michael@0: 
michael@0:   /**
michael@0:    * Represents an indicator, such as a pointer graphic, that points to the
michael@0:    * current item.
michael@0:    */
michael@0:   INDICATOR = 39,
michael@0: 
michael@0:   /**
michael@0:    * Represents a picture. Is is used for xul:image, html:img.
michael@0:    */
michael@0:   GRAPHIC = 40,
michael@0: 
michael@0:   /**
michael@0:    * Represents read-only text, such as labels for other controls or
michael@0:    * instructions in a dialog box. Static text cannot be modified or selected.
michael@0:    * Is is used for xul:label, xul:description, html:label, role="label".
michael@0:    */
michael@0:   STATICTEXT = 41,
michael@0: 
michael@0:   /**
michael@0:    * Represents selectable text that allows edits or is designated read-only.
michael@0:    */
michael@0:   TEXT_LEAF = 42,
michael@0: 
michael@0:   /**
michael@0:    * Represents a push button control. It is used for xul:button, html:button,
michael@0:    * role="button".
michael@0:    */
michael@0:   PUSHBUTTON = 43,
michael@0: 
michael@0:   /**
michael@0:    * Represents a check box control. It is used for xul:checkbox,
michael@0:    * html:input@type="checkbox", role="checkbox".
michael@0:    */
michael@0:   CHECKBUTTON = 44,
michael@0:   
michael@0:   /**
michael@0:    * Represents an option button, also called a radio button. It is one of a
michael@0:    * group of mutually exclusive options. All objects sharing a single parent
michael@0:    * that have this attribute are assumed to be part of single mutually
michael@0:    * exclusive group. It is used for xul:radio, html:input@type="radio",
michael@0:    * role="radio".
michael@0:    */
michael@0:   RADIOBUTTON = 45,
michael@0:   
michael@0:   /**
michael@0:    * Represents a combo box; an edit control with an associated list box that
michael@0:    * provides a set of predefined choices. It is used for html:select,
michael@0:    * xul:menulist, role="combobox".
michael@0:    */
michael@0:   COMBOBOX = 46,
michael@0: 
michael@0:   /**
michael@0:    * Represents the calendar control.
michael@0:    */
michael@0:   DROPLIST = 47,
michael@0: 
michael@0:   /**
michael@0:    * Represents a progress bar, dynamically showing the user the percent
michael@0:    * complete of an operation in progress. It is used for xul:progressmeter,
michael@0:    * role="progressbar".
michael@0:    */
michael@0:   PROGRESSBAR = 48,
michael@0: 
michael@0:   /**
michael@0:    * Represents a dial or knob whose purpose is to allow a user to set a value.
michael@0:    */
michael@0:   DIAL = 49,
michael@0: 
michael@0:   /**
michael@0:    * Represents a hot-key field that allows the user to enter a combination or
michael@0:    * sequence of keystrokes.
michael@0:    */
michael@0:   HOTKEYFIELD = 50,
michael@0: 
michael@0:   /**
michael@0:    * Represents a slider, which allows the user to adjust a setting in given
michael@0:    * increments between minimum and maximum values. It is used by xul:scale,
michael@0:    * role="slider".
michael@0:    */
michael@0:   SLIDER = 51,
michael@0: 
michael@0:   /**
michael@0:    * Represents a spin box, which is a control that allows the user to increment
michael@0:    * or decrement the value displayed in a separate "buddy" control associated
michael@0:    * with the spin box. It is used for xul:spinbuttons.
michael@0:    */
michael@0:   SPINBUTTON = 52,
michael@0: 
michael@0:   /**
michael@0:    * Represents a graphical image used to diagram data. It is used for svg:svg.
michael@0:    */
michael@0:   DIAGRAM = 53,
michael@0:   
michael@0:   /**
michael@0:    * Represents an animation control, which contains content that changes over
michael@0:    * time, such as a control that displays a series of bitmap frames.
michael@0:    */
michael@0:   ANIMATION = 54,
michael@0: 
michael@0:   /**
michael@0:    * Represents a mathematical equation. It is used by MATHML, where there is a
michael@0:    * rich DOM subtree for an equation. Use FLAT_EQUATION for <img role="math" alt="[TeX]"/>
michael@0:    */
michael@0:   EQUATION = 55,
michael@0: 
michael@0:   /**
michael@0:    * Represents a button that drops down a list of items.
michael@0:    */
michael@0:   BUTTONDROPDOWN = 56,
michael@0: 
michael@0:   /**
michael@0:    * Represents a button that drops down a menu.
michael@0:    */
michael@0:   BUTTONMENU = 57,
michael@0: 
michael@0:   /**
michael@0:    * Represents a button that drops down a grid. It is used for xul:colorpicker.
michael@0:    */
michael@0:   BUTTONDROPDOWNGRID = 58,
michael@0: 
michael@0:   /**
michael@0:    * Represents blank space between other objects.
michael@0:    */
michael@0:   WHITESPACE = 59,
michael@0: 
michael@0:   /**
michael@0:    * Represents a container of page tab controls. Is it used for xul:tabs,
michael@0:    * DHTML: role="tabs". Also refer to PAGETAB.
michael@0:    */
michael@0:   PAGETABLIST = 60,
michael@0: 
michael@0:   /**
michael@0:    * Represents a control that displays time.
michael@0:    */
michael@0:   CLOCK = 61,
michael@0: 
michael@0:   /**
michael@0:    * Represents a button on a toolbar that has a drop-down list icon directly
michael@0:    * adjacent to the button.
michael@0:    */
michael@0:   SPLITBUTTON = 62,
michael@0: 
michael@0:   /**
michael@0:    * Represents an edit control designed for an Internet Protocol (IP) address.
michael@0:    * The edit control is divided into sections for the different parts of the
michael@0:    * IP address.
michael@0:    */
michael@0:   IPADDRESS = 63,
michael@0: 
michael@0:   /**
michael@0:    * Represents a label control that has an accelerator.
michael@0:    */
michael@0:   ACCEL_LABEL = 64,
michael@0: 
michael@0:   /**
michael@0:    * Represents an arrow in one of the four cardinal directions.
michael@0:    */
michael@0:   ARROW  = 65,
michael@0: 
michael@0:   /**
michael@0:    * Represents a control that can be drawn into and is used to trap events.
michael@0:    * It is used for html:canvas.
michael@0:    */
michael@0:   CANVAS = 66,
michael@0: 
michael@0:   /**
michael@0:    * Represents a menu item with a check box.
michael@0:    */
michael@0:   CHECK_MENU_ITEM = 67,
michael@0: 
michael@0:   /**
michael@0:    * Represents a specialized dialog that lets the user choose a color.
michael@0:    */
michael@0:   COLOR_CHOOSER  = 68,
michael@0: 
michael@0:   /**
michael@0:    * Represents control whose purpose is to allow a user to edit a date.
michael@0:    */
michael@0:   DATE_EDITOR = 69,
michael@0: 
michael@0:   /**
michael@0:    * An iconified internal frame in an DESKTOP_PANE. Also refer to
michael@0:    * INTERNAL_FRAME.
michael@0:    */
michael@0:   DESKTOP_ICON = 70,
michael@0: 
michael@0:   /**
michael@0:    * A desktop pane. A pane that supports internal frames and iconified
michael@0:    * versions of those internal frames.
michael@0:    */
michael@0:   DESKTOP_FRAME = 71,
michael@0: 
michael@0:   /**
michael@0:    * A directory pane. A pane that allows the user to navigate through
michael@0:    * and select the contents of a directory. May be used by a file chooser.
michael@0:    * Also refer to FILE_CHOOSER.
michael@0:    */
michael@0:   DIRECTORY_PANE = 72,
michael@0: 
michael@0:   /**
michael@0:    * A file chooser. A specialized dialog that displays the files in the
michael@0:    * directory and lets the user select a file, browse a different directory,
michael@0:    * or specify a filename. May use the directory pane to show the contents of
michael@0:    * a directory. Also refer to DIRECTORY_PANE.
michael@0:    */
michael@0:   FILE_CHOOSER = 73,
michael@0: 
michael@0:   /**
michael@0:    * A font chooser. A font chooser is a component that lets the user pick
michael@0:    * various attributes for fonts.
michael@0:    */
michael@0:   FONT_CHOOSER = 74,
michael@0: 
michael@0:   /**
michael@0:    * Frame role. A top level window with a title bar, border, menu bar, etc.
michael@0:    * It is often used as the primary window for an application.
michael@0:    */
michael@0:   CHROME_WINDOW = 75,
michael@0: 
michael@0:   /**
michael@0:    *  A glass pane. A pane that is guaranteed to be painted on top of all
michael@0:    * panes beneath it. Also refer to ROOT_PANE.
michael@0:    */
michael@0:   GLASS_PANE = 76,
michael@0: 
michael@0:   /**
michael@0:    * A document container for HTML, whose children represent the document
michael@0:    * content.
michael@0:    */
michael@0:   HTML_CONTAINER = 77,
michael@0: 
michael@0:   /**
michael@0:    * A small fixed size picture, typically used to decorate components.
michael@0:    */
michael@0:   ICON = 78,
michael@0: 
michael@0:   /**
michael@0:    * Presents an icon or short string in an interface.
michael@0:    */
michael@0:   LABEL = 79,
michael@0: 
michael@0:   /**
michael@0:    * A layered pane. A specialized pane that allows its children to be drawn
michael@0:    * in layers, providing a form of stacking order. This is usually the pane
michael@0:    * that holds the menu bar as  well as the pane that contains most of the
michael@0:    * visual components in a window. Also refer to GLASS_PANE and
michael@0:    * ROOT_PANE.
michael@0:    */
michael@0:   LAYERED_PANE = 80,
michael@0: 
michael@0:   /**
michael@0:    * A specialized pane whose primary use is inside a dialog.
michael@0:    */
michael@0:   OPTION_PANE = 81,
michael@0: 
michael@0:   /**
michael@0:    * A text object uses for passwords, or other places where the text content
michael@0:    * is not shown visibly to the user.
michael@0:    */
michael@0:   PASSWORD_TEXT = 82,
michael@0: 
michael@0:   /**
michael@0:    * A temporary window that is usually used to offer the user a list of
michael@0:    * choices, and then hides when the user selects one of those choices.
michael@0:    */
michael@0:   POPUP_MENU = 83,
michael@0: 
michael@0:   /**
michael@0:    * A radio button that is a menu item.
michael@0:    */
michael@0:   RADIO_MENU_ITEM = 84,
michael@0: 
michael@0:   /**
michael@0:    * A root pane. A specialized pane that has a glass pane and a layered pane
michael@0:    * as its children. Also refer to GLASS_PANE and LAYERED_PANE.
michael@0:    */
michael@0:   ROOT_PANE = 85,
michael@0: 
michael@0:   /**
michael@0:    * A scroll pane. An object that allows a user to incrementally view a large
michael@0:    * amount of information.  Its children can include scroll bars and a
michael@0:    * viewport. Also refer to VIEW_PORT.
michael@0:    */
michael@0:   SCROLL_PANE = 86,
michael@0: 
michael@0:   /**
michael@0:    * A split pane. A specialized panel that presents two other panels at the
michael@0:    * same time. Between the two panels is a divider the user can manipulate to
michael@0:    * make one panel larger and the other panel smaller.
michael@0:    */
michael@0:   SPLIT_PANE = 87,
michael@0: 
michael@0:   /**
michael@0:    * The header for a column of a table.
michael@0:    * XXX: it looks this role is dupe of COLUMNHEADER.
michael@0:    */
michael@0:   TABLE_COLUMN_HEADER = 88,
michael@0: 
michael@0:   /**
michael@0:    * The header for a row of a table.
michael@0:    * XXX: it looks this role is dupe of ROWHEADER
michael@0:    */
michael@0:   TABLE_ROW_HEADER = 89,
michael@0: 
michael@0:   /**
michael@0:    * A menu item used to tear off and reattach its menu.
michael@0:    */
michael@0:   TEAR_OFF_MENU_ITEM = 90,
michael@0: 
michael@0:   /**
michael@0:    * Represents an accessible terminal.
michael@0:    */
michael@0:   TERMINAL = 91,
michael@0: 
michael@0:   /**
michael@0:    * Collection of objects that constitute a logical text entity.
michael@0:    */
michael@0:   TEXT_CONTAINER = 92,
michael@0: 
michael@0:   /**
michael@0:    * A toggle button. A specialized push button that can be checked or
michael@0:    * unchecked, but does not provide a separate indicator for the current state.
michael@0:    */
michael@0:   TOGGLE_BUTTON = 93,
michael@0: 
michael@0:   /**
michael@0:    * Represent a control that is capable of expanding and collapsing rows as
michael@0:    * well as showing multiple columns of data.
michael@0:    */
michael@0:   TREE_TABLE = 94,
michael@0: 
michael@0:   /**
michael@0:    * A viewport. An object usually used in a scroll pane. It represents the
michael@0:    * portion of the entire data that the user can see. As the user manipulates
michael@0:    * the scroll bars, the contents of the viewport can change. Also refer to
michael@0:    * SCROLL_PANE.
michael@0:    */
michael@0:   VIEWPORT = 95,
michael@0: 
michael@0:   /**
michael@0:    * Header of a document page. Also refer to FOOTER.
michael@0:    */
michael@0:   HEADER = 96,
michael@0: 
michael@0:   /**
michael@0:    * Footer of a document page. Also refer to HEADER.
michael@0:    */
michael@0:   FOOTER = 97,
michael@0: 
michael@0:   /**
michael@0:    * A paragraph of text.
michael@0:    */
michael@0:   PARAGRAPH = 98,
michael@0: 
michael@0:   /**
michael@0:    * A ruler such as those used in word processors.
michael@0:    */
michael@0:   RULER = 99,
michael@0: 
michael@0:   /**
michael@0:    * A text entry having dialog or list containing items for insertion into
michael@0:    * an entry widget, for instance a list of words for completion of a
michael@0:    * text entry. It is used for xul:textbox@autocomplete
michael@0:    */
michael@0:   AUTOCOMPLETE = 100,
michael@0: 
michael@0:   /**
michael@0:    *  An editable text object in a toolbar.
michael@0:    */
michael@0:   EDITBAR = 101,
michael@0: 
michael@0:   /**
michael@0:    * An control whose textual content may be entered or modified by the user.
michael@0:    */
michael@0:   ENTRY = 102,
michael@0: 
michael@0:   /**
michael@0:    * A caption describing another object.
michael@0:    */
michael@0:   CAPTION = 103,
michael@0: 
michael@0:   /**
michael@0:    * A visual frame or container which contains a view of document content.
michael@0:    * Document frames may occur within another Document instance, in which case
michael@0:    * the second document may be said to be embedded in the containing instance.
michael@0:    * HTML frames are often DOCUMENT_FRAME. Either this object, or a
michael@0:    * singleton descendant, should implement the Document interface.
michael@0:    */
michael@0:   DOCUMENT_FRAME = 104,
michael@0: 
michael@0:   /**
michael@0:    * Heading.
michael@0:    */
michael@0:   HEADING = 105,
michael@0: 
michael@0:   /**
michael@0:    * An object representing a page of document content.  It is used in documents
michael@0:    * which are accessed by the user on a page by page basis.
michael@0:    */
michael@0:   PAGE = 106,
michael@0: 
michael@0:   /**
michael@0:    * A container of document content.  An example of the use of this role is to
michael@0:    * represent an html:div.
michael@0:    */
michael@0:   SECTION = 107,
michael@0: 
michael@0:   /**
michael@0:    * An object which is redundant with another object in the accessible
michael@0:    * hierarchy. ATs typically ignore objects with this role.
michael@0:    */
michael@0:   REDUNDANT_OBJECT = 108,
michael@0: 
michael@0:   /**
michael@0:    * A container of form controls. An example of the use of this role is to
michael@0:    * represent an html:form.
michael@0:    */
michael@0:   FORM = 109,
michael@0: 
michael@0:   /**
michael@0:    * An object which is used to allow input of characters not found on a
michael@0:    * keyboard, such as the input of Chinese characters on a Western keyboard.
michael@0:    */
michael@0:   IME = 110,
michael@0: 
michael@0:   /**
michael@0:    * XXX: document this.
michael@0:    */
michael@0:   APP_ROOT = 111,
michael@0: 
michael@0:   /**
michael@0:    * Represents a menu item, which is an entry in a menu that a user can choose
michael@0:    * to display another menu.
michael@0:    */
michael@0:   PARENT_MENUITEM = 112,
michael@0: 
michael@0:   /**
michael@0:    * A calendar that allows the user to select a date.
michael@0:    */
michael@0:   CALENDAR = 113,
michael@0: 
michael@0:   /**
michael@0:    * A list of items that is shown by combobox.
michael@0:    */
michael@0:   COMBOBOX_LIST = 114,
michael@0: 
michael@0:   /**
michael@0:    * A item of list that is shown by combobox.
michael@0:    */
michael@0:   COMBOBOX_OPTION = 115,
michael@0: 
michael@0:   /**
michael@0:    * An image map -- has child links representing the areas
michael@0:    */
michael@0:   IMAGE_MAP = 116,
michael@0:   
michael@0:   /**
michael@0:    * An option in a listbox
michael@0:    */
michael@0:   OPTION = 117,
michael@0:   
michael@0:   /**
michael@0:    * A rich option in a listbox, it can have other widgets as children
michael@0:    */
michael@0:   RICH_OPTION = 118,
michael@0:   
michael@0:   /**
michael@0:    * A list of options
michael@0:    */
michael@0:   LISTBOX = 119,
michael@0: 
michael@0:   /**
michael@0:    * Represents a mathematical equation in the accessible name
michael@0:    */
michael@0:   FLAT_EQUATION = 120,
michael@0:   
michael@0:   /**
michael@0:    * Represents a cell within a grid. It is used for role="gridcell". Unlike
michael@0:    * CELL, it allows the calculation of the accessible name from subtree.
michael@0:    * Also, see TABLE.
michael@0:    */
michael@0:   GRID_CELL = 121,
michael@0: 
michael@0:   /**
michael@0:    * Represents an embedded object. It is used for html:object or html:embed.
michael@0:    */
michael@0:   EMBEDDED_OBJECT = 122,
michael@0: 
michael@0:   /**
michael@0:    * A note. Originally intended to be hidden until activated, but now also used
michael@0:    * for things like html 'aside'.
michael@0:    */
michael@0:   NOTE = 123,
michael@0: 
michael@0:   /**
michael@0:    * A figure. Used for things like HTML5 figure element.
michael@0:    */
michael@0:   FIGURE = 124,
michael@0: 
michael@0:   /**
michael@0:    * Represents a rich item with a check box.
michael@0:    */
michael@0:   CHECK_RICH_OPTION = 125,
michael@0: 
michael@0:   /**
michael@0:    * Represent a definition list (dl in HTML).
michael@0:    */
michael@0:   DEFINITION_LIST = 126,
michael@0: 
michael@0:   /**
michael@0:    * Represent a term in a definition list (dt in HTML).
michael@0:    */
michael@0:   TERM = 127,
michael@0: 
michael@0:   /**
michael@0:    * Represent a definition in a definition list (dd in HTML)
michael@0:    */
michael@0:   DEFINITION = 128,
michael@0: 
michael@0:   /**
michael@0:    * Represent a keyboard or keypad key (ARIA role "key").
michael@0:    */
michael@0:   KEY = 129
michael@0: };
michael@0: 
michael@0: } // namespace role
michael@0: 
michael@0: typedef enum mozilla::a11y::roles::Role role;
michael@0: 
michael@0: } // namespace a11y
michael@0: } // namespace mozilla
michael@0: 
michael@0: #endif