--- /dev/null
+<node name="/node" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
+
+<tp:title>AT-SPI - Assistive Technology Service Provider Interface </tp:title>
+<tp:copyright>Copyright 2008 Novell, Inc.</tp:copyright>
+<tp:copyright>Copyright 2001 Sun Microsystems Inc.</tp:copyright>
+<tp:license xmlns="http://www.w3.org/1999/xhtml">
+ <p>This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Library General Public
+ License as published by the Free Software Foundation; either
+ version 2 of the License, or (at your option) any later version.</p>
+
+ <p>This library is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ Library General Public License for more details.</p>
+
+ <p>You should have received a copy of the GNU Library General Public
+ License along with this library; if not, write to the
+ Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ Boston, MA 02111-1307, USA.</p>
+</tp:license>
+<tp:enum name="Role" type="u">
+ <tp:enumvalue suffix="ROLE_INVALID">
+ <tp:docstring>
+ A Role indicating an error condition, such as uninitialized Role data.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_ACCELERATOR_LABEL" value="1">
+ <tp:docstring>
+ Object is a label indicating the keyboard accelerators for the parent
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_ALERT" value="2">
+ <tp:docstring>
+ Object is used to alert the user about something
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_ANIMATION" value="3">
+ <tp:docstring>
+ Object contains a dynamic or moving image of some kind
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_ARROW" value="4">
+ <tp:docstring>
+ Object is a 2d directional indicator
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_CALENDAR" value="5">
+ <tp:docstring>
+ Object contains one or more dates, usually arranged into a 2d list
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_CANVAS" value="6">
+ <tp:docstring>
+ Object that can be drawn into and is used to trap events
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_CHECK_BOX" value="7">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>A choice that can be checked or unchecked and provides a separate
+ indicator for the current state.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_CHECK_MENU_ITEM" value="8">
+ <tp:docstring>
+ A menu item that behaves like a check box (see ROLE_CHECK_BOX)
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_COLOR_CHOOSER" value="9">
+ <tp:docstring>
+ A specialized dialog that lets the user choose a color.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_COLUMN_HEADER" value="10">
+ <tp:docstring>
+ The header for a column of data
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_COMBO_BOX" value="11">
+ <tp:docstring>
+ A list of choices the user can select from
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_DATE_EDITOR" value="12">
+ <tp:docstring>
+ An object which allows entry of a date
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_DESKTOP_ICON" value="13">
+ <tp:docstring>
+ An inconifed internal frame within a DESKTOP_PANE
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_DESKTOP_FRAME" value="14">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>A pane that supports internal frames and iconified versions of those
+ internal frames.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_DIAL" value="15">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object that allows a value to be changed via rotating a visual element,
+ or which displays a value via such a rotating element. </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_DIALOG" value="16">
+ <tp:docstring>
+ A top level window with title bar and a border
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_DIRECTORY_PANE" value="17">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>A pane that allows the user to navigate through and select the contents
+ of a directory</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_DRAWING_AREA" value="18">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>A specialized dialog that displays the files in the directory and lets
+ the user select a file, browse a different directory, or specify a
+ filename.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_FILE_CHOOSER" value="19">
+ <tp:docstring>
+ An object used for drawing custom user interface elements.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_FILLER" value="20">
+ <tp:docstring>
+ A object that fills up space in a user interface
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_FOCUS_TRAVERSABLE" value="21">
+ <tp:docstring>
+ XXX Don't use, reserved for future use.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_FONT_CHOOSER" value="22">
+ <tp:docstring>
+ Allows selection of a display font
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_FRAME" value="23">
+ <tp:docstring>
+ A top level window with a title bar, border, menubar, etc.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_GLASS_PANE" value="24">
+ <tp:docstring>
+ A pane that is guaranteed to be painted on top of all panes beneath it
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_HTML_CONTAINER" value="25">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>A document container for HTML, whose children
+ represent the document content.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_ICON" value="26">
+ <tp:docstring>
+ A small fixed size picture, typically used to decorate components
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_IMAGE" value="27">
+ <tp:docstring>
+ An image, typically static.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_INTERNAL_FRAME" value="28">
+ <tp:docstring>
+ A frame-like object that is clipped by a desktop pane.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_LABEL" value="29">
+ <tp:docstring>
+ An object used to present an icon or short string in an interface
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_LAYERED_PANE" value="30">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>A specialized pane that allows its children to be drawn in layers,
+ providing a form of stacking order.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_LIST" value="31">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object that presents a list of objects to the user and allows the
+ user to select one or more of them.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_LIST_ITEM" value="32">
+ <tp:docstring>
+ An object that represents an element of a list.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_MENU" value="33">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object usually found inside a menu bar that contains a list of
+ actions the user can choose from.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_MENU_BAR" value="34">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object usually drawn at the top of the primary dialog box of an
+ application that contains a list of menus the user can choose from.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_MENU_ITEM" value="35">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object usually contained in a menu that presents an action the
+ user can choose.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_OPTION_PANE" value="36">
+ <tp:docstring>
+ A specialized pane whose primary use is inside a DIALOG
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_PAGE_TAB" value="37">
+ <tp:docstring>
+ An object that is a child of a page tab list
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_PAGE_TAB_LIST" value="38">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object that presents a series of panels (or page tabs), one at a time,
+ through some mechanism provided by the object.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_PANEL" value="39">
+ <tp:docstring>
+ A generic container that is often used to group objects.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_PASSWORD_TEXT" value="40">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>A text object uses for passwords, or other places where the text
+ content is not shown visibly to the user.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_POPUP_MENU" value="41">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>A temporary window that is usually used to offer the user a list of
+ choices, and then hides when the user selects one of those choices.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_PROGRESS_BAR" value="42">
+ <tp:docstring>
+ An object used to indicate how much of a task has been completed.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_PUSH_BUTTON" value="43">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object the user can manipulate to tell the application to do
+ something.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_RADIO_BUTTON" value="44">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>A specialized check box that will cause other radio buttons in the
+ same group to become uncghecked when this one is checked.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_RADIO_MENU_ITEM" value="45">
+ <tp:docstring>
+ Object is both a menu item and a "radio button" (see ROLE_RADIO_BUTTON)
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_ROOT_PANE" value="46">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>A specialized pane that has a glass pane and a layered pane as its
+ children.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_ROW_HEADER" value="47">
+ <tp:docstring>
+ The header for a row of data
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_SCROLL_BAR" value="48">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object usually used to allow a user to incrementally view a large
+ amount of data by moving the bounds of a viewport along a one-dimensional axis.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_SCROLL_PANE" value="49">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object that allows a user to incrementally view a large amount
+ of information. ROLE_SCROLL_PANE objects are usually accompanied by
+ ROLE_SCROLL_BAR controllers, on which the RELATION_CONTROLLER_FOR and
+ RELATION_CONTROLLED_BY reciprocal relations are set; \see
+ Accessibility::RelationSet.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_SEPARATOR" value="50">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object usually contained in a menu to provide a visible and
+ logical separation of the contents in a menu.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_SLIDER" value="51">
+ <tp:docstring>
+ An object that allows the user to select from a bounded range
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_SPIN_BUTTON" value="52">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object which allows one of a set of choices to be selected,
+ and which displays the current choice. Unlike ROLE_SCROLL_BAR,
+ ROLE_SLIDER objects need not control 'viewport'-like objects.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_SPLIT_PANE" value="53">
+ <tp:docstring>
+ A specialized panel that presents two other panels at the same time.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_STATUS_BAR" value="54">
+ <tp:docstring>
+ Object displays non-quantitative status information (c.f. ROLE_PROGRESS_BAR)
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_TABLE" value="55">
+ <tp:docstring>
+ An object used to repesent information in terms of rows and columns.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_TABLE_CELL" value="56">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>A 'cell' or discrete child within a Table. \note Table cells need not have ROLE_TABLE_CELL,
+ other RoleType values are valid as well. </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_TABLE_COLUMN_HEADER" value="57">
+ <tp:docstring>
+ An object which labels a particular column in a Table.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_TABLE_ROW_HEADER" value="58">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object which labels a particular row in a Table. Table rows and columns may also be
+ labelled via the RELATION_LABEL_FOR/RELATION_LABELLED_BY relationships;
+ \see Accessibility::RelationSet. </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_TEAROFF_MENU_ITEM" value="59">
+ <tp:docstring>
+ Object allows menu to be removed from menubar and shown in its own window.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_TERMINAL" value="60">
+ <tp:docstring>
+ An object that emulates a terminal
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_TEXT" value="61">
+ <tp:docstring>
+ An object that presents text to the user, of nonspecific type.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_TOGGLE_BUTTON" value="62">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>A specialized push button that can be checked or unchecked, but does
+ not procide a separate indicator for the current state.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_TOOL_BAR" value="63">
+ <tp:docstring>
+ A bar or palette usually composed of push buttons or toggle buttons
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_TOOL_TIP" value="64">
+ <tp:docstring>
+ An object that provides information about another object
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_TREE" value="65">
+ <tp:docstring>
+ An object used to repsent hierarchical information to the user.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_TREE_TABLE" value="66">
+ <tp:docstring>
+ An object that presents both tabular and hierarchical info to the user
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_UNKNOWN" value="67">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object contains some Accessible information, but its role is
+ not known. </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_VIEWPORT" value="68">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object usually used in a scroll pane, or to otherwise clip a larger object or
+ content renderer to a specific onscreen viewport. </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_WINDOW" value="69">
+ <tp:docstring>
+ A ¨top level window¨ with no title or border.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_EXTENDED" value="70">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>means that the role for this item is known, but not included in the
+ core enumeration </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_HEADER" value="71">
+ <tp:docstring>
+ An object that serves as a document header.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_FOOTER" value="72">
+ <tp:docstring>
+ An object that serves as a document footer.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_PARAGRAPH" value="73">
+ <tp:docstring>
+ An object which is contains a single paragraph of text content. \see also ROLE_TEXT.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_RULER" value="74">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object which describes margins and tab stops, etc.
+ for text objects which it controls
+ (should have CONTROLLER_FOR relation to such). </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_APPLICATION" value="75">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>An object corresponding to the toplevel accessible of an
+ application, which may contain ROLE_FRAME objects or other
+ accessible objects. Children of AccessibleDesktop objects
+ are generally ROLE_APPLICATION objects.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_AUTOCOMPLETE" value="76">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object is a dialog or list containing items for insertion
+ into an entry widget, for instance a list of words for completion
+ of a text entry.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_EDITBAR" value="77">
+ <tp:docstring>
+ The object is an editable text object in a toolbar.
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_EMBEDDED" value="78">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object is an embedded component container. This role is a
+ "grouping" hint that the contained objects share a context which is
+ different from the container in which this accessible is embedded.
+ In particular, it is used for some kinds of document embedding, and
+ for embedding of out-of-process component, "panel applets", etc.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_ENTRY" value="79">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object is a component whose textual content may be entered or modified by the user,
+ provided STATE_EDITABLE is present.
+ @note a readonly ROLE_ENTRY object (i.e. where STATE_EDITABLE is not present) implies a
+ read-only ¨text field¨ in a form, as opposed to a title, label, or caption. </p>
+
+ <p>@since AT-SPI 1.7.0</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_CHART" value="80">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object is a graphical depiction of quantitative data. It may contain multiple
+ subelements whose attributes and/or description may be queried to obtain both the
+ quantitative data and information about how the data is being presented.
+ The LABELLED_BY relation is particularly important in interpreting objects of this type,
+ as is the accessible-description property.
+ @see ROLE_CAPTION </p>
+
+ <p>@since AT-SPI 1.7.0</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_CAPTION" value="81">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object contains descriptive information, usually textual, about another user interface
+ element such as a table, chart, or image. </p>
+
+ <p>@since AT-SPI 1.7.0</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_DOCUMENT_FRAME" value="82">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object is a visual frame or container which contains a view of document content.
+ Document frames may occur within another Document instance, in which case the second
+ document may be said to be embedded in the containing instance. HTML frames are
+ often ROLE_DOCUMENT_FRAME. Either this object, or a singleton descendant, should implement
+ the Document interface. </p>
+
+ <p>@since AT-SPI 1.7.0</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_HEADING" value="83">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object serves as a heading for content which follows it in a document.
+ The 'heading level' of the heading, if availabe, may be obtained by
+ querying the object's attributes. </p>
+
+ <p>@since AT-SPI 1.7.0</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_PAGE" value="84">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object is a containing instance which encapsulates a page of
+ information. ROLE_PAGE is used in documents and content which support
+ a paginated navigation model. </p>
+
+ <p>@since AT-SPI 1.7.0</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_SECTION" value="85">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object is a containing instance of document content which constitutes
+ a particular 'logical' section of the document. The type of content within
+ a section, and the nature of the section division itself, may be obtained
+ by querying the object's attributes. Sections may be nested. </p>
+
+ <p>@since AT-SPI 1.7.0</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_REDUNDANT_OBJECT" value="86">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object is redundant with another object in the hierarchy,
+ and is exposed for purely technical reasons. Objects of this role
+ should be ignored by clients, if they are encountered at all. </p>
+
+ <p>@since AT-SPI 1.7.6</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_FORM" value="87">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object is a containing instance of document content which
+ has within it components with which the user can interact in order to
+ input information; i.e. the object is a container for pushbuttons,
+ comboboxes, text input fields, and other 'GUI' components.
+ ROLE_FORM should not, in general, be used for toplevel GUI containers
+ or dialogs, but should be reserved for 'GUI' containers which occur within
+ document content, for instance within Web documents, presentations, or
+ text documents. Unlike other GUI containers and dialogs which occur inside
+ application instances, ROLE_FORM containers' components are associated with
+ the current document, rather than the current foreground application or
+ viewer instance. </p>
+
+ <p>@since AT-SPI 1.7.6</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_LINK" value="88">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object is a hypertext anchor, i.e. a "link" in a
+ hypertext document. Such objects are distinct from 'inline'
+ content which may also use the Hypertext/Hyperlink interfaces
+ to indicate the range/location within a text object where
+ an inline or embedded object lies. </p>
+
+ <p>@since AT-SPI 1.7.6</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_INPUT_METHOD_WINDOW" value="89">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The object is a window or similar viewport which is used
+ to allow composition or input of a 'complex character',
+ in other words it is an "input method window." </p>
+
+ <p>@since AT-SPI 1.7.6</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="ROLE_LAST_DEFINED" value="90">
+ <tp:docstring>
+ not a valid role, used for finding end of enumeration.
+ </tp:docstring>
+ </tp:enumvalue>
+</tp:enum>
+</node>
--- /dev/null
+<node name="/node" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
+
+<tp:title>AT-SPI - Assistive Technology Service Provider Interface </tp:title>
+<tp:copyright>Copyright 2008 Novell, Inc.</tp:copyright>
+<tp:copyright>Copyright 2001 Sun Microsystems Inc.</tp:copyright>
+<tp:license xmlns="http://www.w3.org/1999/xhtml">
+ <p>This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Library General Public
+ License as published by the Free Software Foundation; either
+ version 2 of the License, or (at your option) any later version.</p>
+
+ <p>This library is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ Library General Public License for more details.</p>
+
+ <p>You should have received a copy of the GNU Library General Public
+ License along with this library; if not, write to the
+ Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ Boston, MA 02111-1307, USA.</p>
+</tp:license>
+<tp:enum name="StateType" type="u">
+ <tp:enumvalue suffix="STATE_INVALID"/>
+ <tp:enumvalue suffix="STATE_ACTIVE" value="1">
+ <tp:docstring>
+ Indicates a window is currently the active window, or is an active subelement within a container or table
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_ARMED" value="2">
+ <tp:docstring>
+ Indicates that the object is armed
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_BUSY" value="3">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates the current object is busy, i.e. onscreen representation is in the process of changing, or
+ the object is temporarily unavailable for interaction due to activity already in progress.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_CHECKED" value="4">
+ <tp:docstring>
+ Indicates this object is currently checked
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_COLLAPSED" value="5">
+ <tp:docstring>
+ Indicates this object is collapsed
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_DEFUNCT" value="6">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates that this object no longer has a valid backing widget
+ (for instance, if its peer object has been destroyed) </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_EDITABLE" value="7">
+ <tp:docstring>
+ Indicates the user can change the contents of this object
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_ENABLED" value="8">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates that this object is enabled, i.e. that it currently reflects some application state.
+ Objects that are "greyed out" may lack this state, and may lack the STATE_SENSITIVE if direct user
+ interaction cannot cause them to acquire STATE_ENABLED. @see STATE_SENSITIVE.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_EXPANDABLE" value="9">
+ <tp:docstring>
+ Indicates this object allows progressive disclosure of its children
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_EXPANDED" value="10">
+ <tp:docstring>
+ Indicates this object its expanded
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_FOCUSABLE" value="11">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates this object can accept keyboard focus, which means all
+ events resulting from typing on the keyboard will normally be passed
+ to it when it has focus</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_FOCUSED" value="12">
+ <tp:docstring>
+ Indicates this object currently has the keyboard focus
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_HAS_TOOLTIP" value="13">
+ <tp:docstring>
+ Indicates that the object has an associated tooltip
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_HORIZONTAL" value="14">
+ <tp:docstring>
+ Indicates the orientation of thsi object is horizontal
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_ICONIFIED" value="15">
+ <tp:docstring>
+ Indicates this object is minimized and is represented only by an icon
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_MODAL" value="16">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates something must be done with this object before the user can
+ interact with an object in a different window.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_MULTI_LINE" value="17">
+ <tp:docstring>
+ Indicates this (text) object can contain multiple lines of text
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_MULTISELECTABLE" value="18">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates this object allows more than one of its children to be
+ selected at the same time, or in the case of text objects,
+ that the object supports non-contiguous text selections.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_OPAQUE" value="19">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates this object paints every pixel within its rectangular region.
+ It also indicates an alpha value of unity, if it supports alpha blending. </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_PRESSED" value="20">
+ <tp:docstring>
+ Indicates this object is currently pressed
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_RESIZABLE" value="21">
+ <tp:docstring>
+ Indicates the size of this object's size is not fixed
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_SELECTABLE" value="22">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates this object is the child of an object that allows its
+ children to be selected and that this child is one of those children
+ that can be selected.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_SELECTED" value="23">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates this object is the child of an object that allows its
+ children to be selected and that this child is one of those children
+ that has been selected.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_SENSITIVE" value="24">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates this object is sensitive, e.g. to user interaction.
+ STATE_SENSITIVE usually accompanies STATE_ENABLED for user-actionable controls,
+ but may be found in the absence of STATE_ENABLED if the current visible state of the
+ control is "disconnected" from the application state. In such cases, direct user interaction
+ can often result in the object gaining STATE_SENSITIVE, for instance if a user makes
+ an explicit selection using an object whose current state is ambiguous or undefined.
+ @see STATE_ENABLED, STATE_INDETERMINATE. </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_SHOWING" value="25">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates this object, the object's parent, the object's parent's
+ parent, and so on, are all 'shown' to the end-user, i.e.
+ subject to "exposure" if blocking or obscuring objects do not interpose
+ between this object and the top of the window stack.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_SINGLE_LINE" value="26">
+ <tp:docstring>
+ Indicates this (text) object can contain only a single line of text
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_STALE" value="27">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates that the information returned for this object may no longer be
+ synchronized with the application state. This can occur if the object has STATE_TRANSIENT,
+ and can also occur towards the end of the object peer's lifecycle. </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_TRANSIENT" value="28">
+ <tp:docstring>
+ Indicates this object is transient
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_VERTICAL" value="29">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates the orientation of this object is vertical; for example this state may appear on
+ such objects as scrollbars, text objects (with vertical text flow), separators, etc.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_VISIBLE" value="30">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates this object is visible, e.g. has been explicitly marked for exposure to the user.
+ @note: STATE_VISIBLE is no guarantee that the object is actually unobscured on the screen, only
+ that it is 'potentially' visible, barring obstruction, being scrolled or clipped out of the
+ field of view, or having an ancestor container that has not yet made visible.
+ A widget is potentially onscreen if it has both STATE_VISIBLE and STATE_SHOWING.
+ The absence of STATE_VISIBLE and STATE_SHOWING is semantically equivalent to saying
+ that an object is 'hidden'.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_MANAGES_DESCENDANTS" value="31">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates that "active-descendant-changed" event is sent when children
+ become 'active' (i.e. are selected or navigated to onscreen). Used to
+ prevent need to enumerate all children in very large containers, like
+ tables. The presence of STATE_MANAGES_DESCENDANTS is an indication to the client.
+ that the children should not, and need not, be enumerated by the client.
+ Objects implementing this state are expected to provide relevant state
+ notifications to listening clients, for instance notifications of visibility
+ changes and activation of their contained child objects, without the client
+ having previously requested references to those children.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_INDETERMINATE" value="32">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates that a check box or other boolean indicator is in a state other than
+ checked or not checked. This usually means that the boolean value reflected or
+ controlled by the object does not apply consistently to the entire current context.
+ For example, a checkbox for the "Bold" attribute of text may have STATE_INDETERMINATE
+ if the currently selected text contains a mixture of weight attributes.
+ In many cases interacting with a STATE_INDETERMINATE object will cause
+ the context's corresponding boolean attribute to be homogenized, whereupon the object
+ will lose STATE_INDETERMINATE and a corresponding state-changed event will be fired.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_REQUIRED" value="33">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates that user interaction with this object is 'required' from the user,
+ for instance before completing the processing of a form.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_TRUNCATED" value="34">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates that an object's onscreen content is truncated, e.g. a text value in a spreadsheet cell.
+ @since AT-SPI 1.7.0.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_ANIMATED" value="35">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Indicates this object's visual representation is dynamic, not static.
+ This state may be applied to an object during an animated 'effect' and
+ be removed from the object once its visual representation becomes static.
+ @note some applications, notably content viewers, may not be able to detect
+ all kinds of animated content. Therefore the absence of this state should not
+ be taken as definitive evidence that the object's visual representation is
+ static; this state is advisory. </p>
+
+ <p>@since AT-SPI 1.7.0</p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_INVALID_ENTRY" value="36">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>This object has indicated an error condition due to failure of input
+ validation. For instance, a form control may acquire this state in response
+ to invalid or malformed user input. </p>
+
+ <p>@since AT-SPI 1.7.0 </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_SUPPORTS_AUTOCOMPLETION" value="37">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>This state indicates that the object in question implements some form of ¨typeahead¨ or
+ pre-selection behavior whereby entering the first character of one or more sub-elements
+ causes those elements to scroll into view or become selected. Subsequent character input
+ may narrow the selection further as long as one or more sub-elements match the string.
+ This state is normally only useful and encountered on objects that implement Selection.
+ In some cases the typeahead behavior may result in full or partial ¨completion¨ of
+ the data in the input field, in which case these input events may trigger text-changed
+ events from the source. </p>
+
+ <p>@since AT-SPI 1.7.0 </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_SELECTABLE_TEXT" value="38">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>This state indicates that the object in question supports text selection.
+ It should only be exposed on objects which implement the Text interface,
+ in order to distinguish this state from STATE_SELECTABLE, which infers that
+ the object in question is a selectable child of an object which implements
+ Selection. While similar, text selection and subelement selection are
+ distinct operations. </p>
+
+ <p>@since AT-SPI 1.7.0 </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_IS_DEFAULT" value="39">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>This state indicates that the object in question is the 'default' interaction object
+ in a dialog, i.e. the one that gets activated if the user presses "Enter" when the
+ dialog is initially posted. </p>
+
+ <p>@since AT-SPI 1.7.0 </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_VISITED" value="40">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>This state indicates that the object (typically a hyperlink)
+ has already been activated or invoked, with the result that some backing data
+ has been downloaded or rendered. </p>
+
+ <p>@since AT-SPI 1.7.1 </p>
+ </tp:docstring>
+ </tp:enumvalue>
+ <tp:enumvalue suffix="STATE_LAST_DEFINED" value="41">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>This value of the enumeration should not be used as a parameter, it indicates the number of
+ items in the StateType enumeration.</p>
+ </tp:docstring>
+ </tp:enumvalue>
+</tp:enum>
+<interface name="org.freedesktop.accessibility.StateSet">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The StateSet interface encapsulates a collection of state information.
+ It allows comparison of state information between object instances, and comparisons
+ of an object's state with some hypothetical collection of states.</p>
+ </tp:docstring>
+ <method name="contains">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Query a StateSet for a specific StateType.
+ @param state the StateType being queried for.</p>
+ </tp:docstring>
+ <arg direction="in" name="state" type="u" tp:type="StateType"/>
+ <arg direction="out" type="b" tp:type="boolean">
+ <tp:docstring>
+ \c TRUE if the StateSet contains StateType \a state.
+ </tp:docstring>
+ </arg>
+ </method>
+ <method name="add">
+ <tp:docstring>
+ Add a StateType to an existing StateSet, if not already present.
+ </tp:docstring>
+ <arg direction="in" name="state" type="u" tp:type="StateType"/>
+ </method>
+ <method name="remove">
+ <tp:docstring>
+ Remove a StateType to an existing StateSet, if it is present.
+ </tp:docstring>
+ <arg direction="in" name="state" type="u" tp:type="StateType"/>
+ </method>
+ <method name="equals">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>Compare two statesets for equivalence.
+ @param tarStateSet the StateSet to be compared with this one.</p>
+ </tp:docstring>
+ <arg direction="in" name="tarStateSet" type="o" tp:type="StateSet"/>
+ <arg direction="out" type="b" tp:type="boolean">
+ <tp:docstring>
+ \c TRUE if the two StateSet objects are composed of the same StateTypes.
+ </tp:docstring>
+ </arg>
+ </method>
+ <method name="compare">
+ <tp:docstring>
+ Compare two StateSet instances and obtain their differences.
+ </tp:docstring>
+ <arg direction="in" name="compareState" type="o" tp:type="StateSet"/>
+ <arg direction="out" type="o" tp:type="StateSet">
+ <tp:docstring>
+ a 'difference set', i.e. a StateSet consisting of those states not shared by the two sets being compared.
+ </tp:docstring>
+ </arg>
+ </method>
+ <method name="isEmpty">
+ <arg direction="out" type="b" tp:type="boolean">
+ <tp:docstring>
+ \c TRUE if the StateSet contains no states.
+ </tp:docstring>
+ </arg>
+ </method>
+ <method name="getStates">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>\cond
+ Private </p>
+ </tp:docstring>
+ <arg direction="out" type="au" tp:type="StateSeq"/>
+ </method>
+ <method name="unImplemented">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>unImplemented: </p>
+
+ <p>placeholders for future expansion.</p>
+ </tp:docstring>
+ </method>
+ <method name="unImplemented2">
+ </method>
+ <method name="unImplemented3">
+ </method>
+ <method name="unImplemented4">
+ </method>
+</interface>
+</node>
projects / platform / core / uifw / at-spi2-atk.git / commitdiff