<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="atk-constants">
  <refnamediv>
    <refname>atk Constants</refname>
    <refpurpose>the built-in constants of the atk module</refpurpose>
  </refnamediv>

  <refsect1>
    <title>Synopsis</title>

    <programlisting>
<xref linkend="atk-coord-type-constants" endterm="atk-coord-type-constants-title"></xref>
<xref linkend="atk-layer-constants" endterm="atk-layer-constants-title"></xref>
<xref linkend="atk-relation-type-constants" endterm="atk-relation-type-constants-title"></xref>
<xref linkend="atk-role-constants" endterm="atk-role-constants-title"></xref>
<xref linkend="atk-state-type-constants" endterm="atk-state-type-constants-title"></xref>
<xref linkend="atk-text-attr-constants" endterm="atk-text-attr-constants-title"></xref>
<xref linkend="atk-text-boundary-constants" endterm="atk-text-boundary-constants-title"></xref>
<xref linkend="atk-text-clip-type-constants" endterm="atk-text-clip-type-constants-title"></xref>
</programlisting>

  </refsect1>

  <refsect1 id="atk-constants-description">
    <title>Description</title>

    <refsect2 id="atk-coord-type-constants">
      <title id="atk-coord-type-constants-title">Atk Coord Type Constants</title>

      <para>The Atk Coord Type constants specify how xy coordinates are to
      be interpreted. Used by methods such as <link
      linkend="method-atkcomponent--get-position"><methodname>atk.Component.get_position</methodname>()</link>
      and <link
      linkend="method-atktext--get-character-extents"><methodname>atk.Text.get_character_extents</methodname>()</link></para>

      <variablelist>
	<varlistentry>
	  <term><literal>atk.XY_SCREEN</literal></term>
	  <listitem>
	    <simpara>specifies xy coordinates relative to the
	    screen</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.XY_WINDOW</literal></term>
	  <listitem>
	    <simpara>specifies xy coordinates relative to the widget's
	    top-level window</simpara>
	  </listitem>
	</varlistentry>
      </variablelist>

    </refsect2>

    <refsect2 id="atk-layer-constants">
      <title id="atk-layer-constants-title">Atk Layer Constants</title>

      <para>The Atk Layer constants specify the layer of a component. These
      enumerated "layer values" are used when determining which UI rendering
      layer a component is drawn into, which can help in making
      determinations of when components occlude one another.</para>

      <variablelist>
	<varlistentry>
	  <term><literal>atk.LAYER_INVALID</literal></term>
	  <listitem>
	    <simpara>The object does not have a layer</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.LAYER_BACKGROUND</literal></term>
	  <listitem>
	    <simpara>This layer is reserved for the desktop
	    background</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.LAYER_CANVAS</literal></term>
	  <listitem>
	    <simpara>This layer is used for Canvas components</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.LAYER_WIDGET</literal></term>
	  <listitem>
	    <simpara>This layer is normally used for components</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.LAYER_MDI</literal></term>
	  <listitem>
	    <simpara>This layer is used for layered components</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.LAYER_POPUP</literal></term>
	  <listitem>
	    <simpara>This layer is used for popup components, such as
	    menus</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.LAYER_OVERLAY</literal></term>
	  <listitem>
	    <simpara>This layer is reserved for future use.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.LAYER_WINDOW</literal></term>
	  <listitem>
	    <simpara>This layer is used for toplevel windows.</simpara>
	  </listitem>
	</varlistentry>
      </variablelist>

    </refsect2>

    <refsect2 id="atk-relation-type-constants">
      <title id="atk-relation-type-constants-title">Atk Relation Type Constants</title>

      <para>The Atk Relation Type constants specify the type of the
      relation.</para>

      <variablelist>
	<varlistentry>
	  <term><literal>atk.RELATION_NULL</literal></term>
	  <listitem>
	    <simpara> Not used, represents "no relationship" or an error
	    condition. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_CONTROLLED_BY</literal></term>
	  <listitem>
	    <simpara> Indicates an object controlled by one or more target
	    objects. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_CONTROLLER_FOR</literal></term>
	  <listitem>
	    <simpara> Indicates an object is an controller for one or more
	    target objects. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_LABEL_FOR</literal></term>
	  <listitem>
	    <simpara> Indicates an object is a label for one or more target
	    objects. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_LABELLED_BY</literal></term>
	  <listitem>
	    <simpara> Indicates an object is labelled by one or more target
	    objects. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_MEMBER_OF</literal></term>
	  <listitem>
	    <simpara> Indicates an object is a member of a group of one or
	    more target objects. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_NODE_CHILD_OF</literal></term>
	  <listitem>
	    <simpara> Indicates an object is a cell in a treetable which is
	    displayed because a cell in the same column is expanded and
	    identifies that cell. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_FLOWS_TO</literal></term>
	  <listitem>
	    <simpara> Indicates that the object has content that flows
	    logically to another <link
	    linkend="class-atkobject"><classname>atk.Object</classname></link>
	    in a sequential way, (for instance text-flow). </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_FLOWS_FROM</literal></term>
	  <listitem>
	    <simpara> Indicates that the object has content that flows
	    logically from another <link
	    linkend="class-atkobject"><classname>atk.Object</classname></link>
	    in a sequential way, (for instance text-flow). </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_SUBWINDOW_OF</literal></term>
	  <listitem>
	    <simpara> Indicates a subwindow attached to a component but
	    otherwise has no connection in the UI hierarchy to that
	    component. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_EMBEDS</literal></term>
	  <listitem>
	    <simpara> Indicates that the object visually embeds another
	    object's content, i.e. this object's content flows around
	    another's content. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_EMBEDDED_BY</literal></term>
	  <listitem>
	    <simpara> Inverse of <literal>atk.RELATION_EMBEDS</literal>,
	    indicates that this object's content is visualy embedded in
	    another object. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_POPUP_FOR</literal></term>
	  <listitem>
	    <simpara>Indicates that an object is a popup for another
	    object.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_PARENT_WINDOW_OF</literal></term>
	  <listitem>
	    <simpara> Indicates that an object is a parent window of another
	    object. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.RELATION_LAST_DEFINED</literal></term>
	  <listitem>
	    <simpara> Not used, this value indicates the end of the
	    enumeration. </simpara>
	  </listitem>
	</varlistentry>
      </variablelist>

    </refsect2>

    <refsect2 id="atk-role-constants">
      <title id="atk-role-constants-title">Atk Role Constants</title>

      <para>The Atk Role constants describes the role of an object.  These
      are the built-in enumerated roles that UI components can have in
      ATK. Other roles may be added at runtime, so an AtkRole >=
      <literal>atk.ROLE_LAST_DEFINED</literal> is not necessarily an
      error.</para>

      <variablelist>
	<varlistentry>
	  <term><literal>atk.ROLE_INVALID</literal></term>
	  <listitem>
	    <simpara>Invalid role</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_ACCEL_LABEL</literal></term>
	  <listitem>
	    <simpara>A label which represents an accelerator</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_ALERT</literal></term>
	  <listitem>
	    <simpara>An object which is an alert to the user</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_ANIMATION</literal></term>
	  <listitem>
	    <simpara>An object which is an animated image</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_ARROW</literal></term>
	  <listitem>
	    <simpara>An arrow in one of the four cardinal directions</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_CALENDAR</literal></term>
	  <listitem>
	    <simpara> An object that displays a calendar and allows the user
	    to select a date </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_CANVAS</literal></term>
	  <listitem>
	    <simpara> An object that can be drawn into and is used to trap
	    events </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_CHECK_BOX</literal></term>
	  <listitem>
	    <simpara> A choice that can be checked or unchecked and provides
	    a separate indicator for the current state </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_CHECK_MENU_ITEM</literal></term>
	  <listitem>
	    <simpara>A menu item with a check box</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_COLOR_CHOOSER</literal></term>
	  <listitem>
	    <simpara>A specialized dialog that lets the user choose a
	    color</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_COLUMN_HEADER</literal></term>
	  <listitem>
	    <simpara>The header for a column of data</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_COMBO_BOX</literal></term>
	  <listitem>
	    <simpara>A list of choices the user can select from</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_DATE_EDITOR</literal></term>
	  <listitem>
	    <simpara>An object whose purpose is to allow a user to edit a
	    date</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_DESKTOP_ICON</literal></term>
	  <listitem>
	    <simpara>An inconifed internal frame within a
	    DESKTOP_PANE</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_DESKTOP_FRAME</literal></term>
	  <listitem>
	    <simpara> A pane that supports internal frames and iconified
	    versions of those internal frames </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_DIAL</literal></term>
	  <listitem>
	    <simpara>An object whose purpose is to allow a user to set a
	    value</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_DIALOG</literal></term>
	  <listitem>
	    <simpara>A top level window with title bar and a border</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_DIRECTORY_PANE</literal></term>
	  <listitem>
	    <simpara> A pane that allows the user to navigate through and
	    select the contents of a directory </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_DRAWING_AREA</literal></term>
	  <listitem>
	    <simpara> An object used for drawing custom user interface
	    elements </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_FILE_CHOOSER</literal></term>
	  <listitem>
	    <simpara>A specialized dialog that lets the user choose a
	    file</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_FILLER</literal></term>
	  <listitem>
	    <simpara>A object that fills up space in a user
	    interface</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_FONT_CHOOSER</literal></term>
	  <listitem>
	    <simpara>A specialized dialog that lets the user choose a
	    font</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_FRAME</literal></term>
	  <listitem>
	    <simpara> A top level window with a title bar, border, menubar,
	    etc. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_GLASS_PANE</literal></term>
	  <listitem>
	    <simpara> A pane that is guaranteed to be painted on top of all
	    panes beneath it </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_HTML_CONTAINER</literal></term>
	  <listitem>
	    <simpara> A document container for HTML, whose children
	    represent the document content </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_ICON</literal></term>
	  <listitem>
	    <simpara> A small fixed size picture, typically used to decorate
	    components </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_IMAGE</literal></term>
	  <listitem>
	    <simpara> An object whose primary purpose is to display an image
	    </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_INTERNAL_FRAME</literal></term>
	  <listitem>
	    <simpara>A frame-like object that is clipped by a desktop
	    pane</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_LABEL</literal></term>
	  <listitem>
	    <simpara> An object used to present an icon or short string in
	    an interface </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_LAYERED_PANE</literal></term>
	  <listitem>
	    <simpara> A specialized pane that allows its children to be
	    drawn in layers, providing a form of stacking order </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_LIST</literal></term>
	  <listitem>
	    <simpara> An object that presents a list of objects to the user
	    and allows the user to select one or more of them </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_LIST_ITEM</literal></term>
	  <listitem>
	    <simpara>An object that represents an element of a
	    list</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_MENU</literal></term>
	  <listitem>
	    <simpara> An object usually found inside a menu bar that
	    contains a list of actions the user can choose from </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_MENU_BAR</literal></term>
	  <listitem>
	    <simpara> 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 </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_MENU_ITEM</literal></term>
	  <listitem>
	    <simpara> An object usually contained in a menu that presents an
	    action the user can choose </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_OPTION_PANE</literal></term>
	  <listitem>
	    <simpara> A specialized pane whose primary use is inside a
	    DIALOG </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_PAGE_TAB</literal></term>
	  <listitem>
	    <simpara> An object that is a child of a page tab list
	    </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_PAGE_TAB_LIST</literal></term>
	  <listitem>
	    <simpara> An object that presents a series of panels (or page
	    tabs), one at a time, through some mechanism provided by the
	    object </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_PANEL</literal></term>
	  <listitem>
	    <simpara>A generic container that is often used to group
	    objects</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_PASSWORD_TEXT</literal></term>
	  <listitem>
	    <simpara> A text object uses for passwords, or other places
	    where the text content is not shown visibly to the user
	    </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_POPUP_MENU</literal></term>
	  <listitem>
	    <simpara> 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 </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_PROGRESS_BAR</literal></term>
	  <listitem>
	    <simpara> An object used to indicate how much of a task has been
	    completed </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_PUSH_BUTTON</literal></term>
	  <listitem>
	    <simpara> An object the user can manipulate to tell the
	    application to do something </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_RADIO_BUTTON</literal></term>
	  <listitem>
	    <simpara> A specialized check box that will cause other radio
	    buttons in the same group to become unchecked when this one is
	    checked </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_RADIO_MENU_ITEM</literal></term>
	  <listitem>
	    <simpara> A check menu item which belongs to a group. At each
	    instant exactly one of the radio menu items from a group is
	    selected</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_ROOT_PANE</literal></term>
	  <listitem>
	    <simpara> A specialized pane that has a glass pane and a layered
	    pane as its children </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_ROW_HEADER</literal></term>
	  <listitem>
	    <simpara>The header for a row of data</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_SCROLL_BAR</literal></term>
	  <listitem>
	    <simpara> An object usually used to allow a user to
	    incrementally view a large amount of data. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_SCROLL_PANE</literal></term>
	  <listitem>
	    <simpara> An object that allows a user to incrementally view a
	    large amount of information </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_SEPARATOR</literal></term>
	  <listitem>
	    <simpara> An object usually contained in a menu to provide a
	    visible and logical separation of the contents in a menu
	    </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_SLIDER</literal></term>
	  <listitem>
	    <simpara> An object that allows the user to select from a
	    bounded range </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_SPLIT_PANE</literal></term>
	  <listitem>
	    <simpara> A specialized panel that presents two other panels at
	    the same time </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_SPIN_BUTTON</literal></term>
	  <listitem>
	    <simpara> An object used to get an integer or floating point
	    number from the user </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_STATUSBAR</literal></term>
	  <listitem>
	    <simpara> An object which reports messages of minor importance
	    to the user </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_TABLE</literal></term>
	  <listitem>
	    <simpara> An object used to represent information in terms of
	    rows and columns </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_TABLE_CELL</literal></term>
	  <listitem>
	    <simpara>A cell in a table</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_TABLE_COLUMN_HEADER</literal></term>
	  <listitem>
	    <simpara>The header for a column of a table</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_TABLE_ROW_HEADER</literal></term>
	  <listitem>
	    <simpara>The header for a row of a table</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_TEAR_OFF_MENU_ITEM</literal></term>
	  <listitem>
	    <simpara>A menu item used to tear off and reattach its
	    menu</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_TERMINAL</literal></term>
	  <listitem>
	    <simpara>An object that represents an accessible
	    terminal</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_TEXT</literal></term>
	  <listitem>
	    <simpara>An object that presents text to the user</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_TOGGLE_BUTTON</literal></term>
	  <listitem>
	    <simpara> A specialized push button that can be checked or
	    unchecked, but does not provide a separate indicator for the
	    current state </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_TOOL_BAR</literal></term>
	  <listitem>
	    <simpara> A bar or palette usually composed of push buttons or
	    toggle buttons </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_TOOL_TIP</literal></term>
	  <listitem>
	    <simpara>An object that provides information about another
	    object</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_TREE</literal></term>
	  <listitem>
	    <simpara> An object used to represent hierarchical information
	    to the user </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_TREE_TABLE</literal></term>
	  <listitem>
	    <simpara> An object capable of expanding and collapsing rows as
	    well as showing multiple columns of data </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_UNKNOWN</literal></term>
	  <listitem>
	    <simpara> The object contains some Accessible information, but
	    its role is not known </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_VIEWPORT</literal></term>
	  <listitem>
	    <simpara>An object usually used in a scroll pane</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_WINDOW</literal></term>
	  <listitem>
	    <simpara>A top level window with no title or border.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_HEADER</literal></term>
	  <listitem>
	    <simpara>An object that serves as a document header.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_FOOTER</literal></term>
	  <listitem>
	    <simpara>An object that serves as a document footer.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_PARAGRAPH</literal></term>
	  <listitem>
	    <simpara>An object which is contains a paragraph of text
	    content.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_RULER</literal></term>
	  <listitem>
	    <simpara> An object which describes margins and tab stops,
	    etc. for text objects which it controls (should have
	    CONTROLLER_FOR relation to such). </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_APPLICATION</literal></term>
	  <listitem>
	    <simpara> The object is an application object, which may contain
	    atk.ROLE_FRAME objects or other types of accessibles. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_AUTOCOMPLETE</literal></term>
	  <listitem>
	    <simpara> 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. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_EDITBAR</literal></term>
	  <listitem>
	    <simpara>The object is an editable text object in a
	    toolbar</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_EMBEDDED</literal></term>
	  <listitem>
	    <simpara> The object is an embedded container within a document
	    or panel. This role is a grouping "hint" indicating that the
	    contained objects share a context. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_ENTRY</literal></term>
	  <listitem>
	    <simpara> The object is a component whose textual content may be
	    entered or modified by the user, provided atk.STATE_EDITABLE is
	    present. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_CHART</literal></term>
	  <listitem>
	    <simpara> 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. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_CAPTION</literal></term>
	  <listitem>
	    <simpara> The object contains descriptive information, usually
	    textual, about another user interface element such as a table,
	    chart, or image. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_DOCUMENT_FRAME</literal></term>
	  <listitem>
	    <simpara> 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. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_HEADING</literal></term>
	  <listitem>
	    <simpara> 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. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_PAGE</literal></term>
	  <listitem>
	    <simpara> The object is a containing instance which encapsulates
	    a page of information. atk.ROLE_PAGE is used in documents and
	    content which support a paginated navigation model. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_SECTION</literal></term>
	  <listitem>
	    <simpara> 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. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_REDUNDANT_OBJECT</literal></term>
	  <listitem>
	    <simpara> The object is redundant with another object in the
	    hierarchy, and is exposed for purely technical reasons. Objects
	    of this role should normally be ignored by clients. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.ROLE_LAST_DEFINED</literal></term>
	  <listitem>
	    <simpara>not a valid role, used for finding end of the
	    enumeration</simpara>
	  </listitem>
	</varlistentry>
      </variablelist>

    </refsect2>

    <refsect2 id="atk-state-type-constants">
      <title id="atk-state-type-constants-title">Atk State Type Constants</title>

      <para>The Atk State Type constants specify a particular state of a
      component. The actual state of an component is described by its <link
      linkend="class-atkstateset"><classname>atk.StateSet</classname></link>,
      which is a set of states.</para>

      <variablelist>
	<varlistentry>
	  <term><literal>atk.STATE_INVALID</literal></term>
	  <listitem>
	    <simpara>Indicates an invalid state</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_ACTIVE</literal></term>
	  <listitem>
	    <simpara>Indicates a window is currently the active
	    window</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_ARMED</literal></term>
	  <listitem>
	    <simpara>Indicates that the object is armed.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_BUSY</literal></term>
	  <listitem>
	    <simpara> Indicates the current object is busy. This state may
	    be used by implementors of Document to indicate that content
	    loading is in process. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_CHECKED</literal></term>
	  <listitem>
	    <simpara>Indicates this object is currently checked</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_DEFUNCT</literal></term>
	  <listitem>
	    <simpara> Indicates the user interface object corresponding to
	    this object no longer exists </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_EDITABLE</literal></term>
	  <listitem>
	    <simpara> Indicates the user can change the contents of this
	    object </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_ENABLED</literal></term>
	  <listitem>
	    <simpara> Indicates that this object is enabled. An inconsistent
	    <link
	    linkend="class-gtktogglebutton"><classname>gtk.ToggleButton</classname></link>
	    is an example of an object which is sensitive but not
	    enabled. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_EXPANDABLE</literal></term>
	  <listitem>
	    <simpara> Indicates this object allows progressive disclosure of
	    its children </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_EXPANDED</literal></term>
	  <listitem>
	    <simpara>Indicates this object its expanded</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_FOCUSABLE</literal></term>
	  <listitem>
	    <simpara> 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 </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_FOCUSED</literal></term>
	  <listitem>
	    <simpara>Indicates this object currently has the keyboard
	    focus</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_HORIZONTAL</literal></term>
	  <listitem>
	    <simpara>Indicates the orientation of this object is
	    horizontal</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_ICONIFIED</literal></term>
	  <listitem>
	    <simpara> Indicates this object is minimized and is represented
	    only by an icon </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_MODAL</literal></term>
	  <listitem>
	    <simpara> Indicates something must be done with this object
	    before the user can interact with an object in a different
	    window </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_MULTI_LINE</literal></term>
	  <listitem>
	    <simpara> Indicates this (text) object can contain multiple lines of text </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_MULTISELECTABLE</literal></term>
	  <listitem>
	    <simpara> Indicates this object allows more than one of its
	    children to be selected at the same time </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_OPAQUE</literal></term>
	  <listitem>
	    <simpara> Indicates this object paints every pixel within its
	    rectangular region. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_PRESSED</literal></term>
	  <listitem>
	    <simpara>Indicates this object is currently pressed</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_RESIZABLE</literal></term>
	  <listitem>
	    <simpara>Indicates the size of this object is not fixed</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_SELECTABLE</literal></term>
	  <listitem>
	    <simpara> 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 </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_SELECTED</literal></term>
	  <listitem>
	    <simpara> 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 </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_SENSITIVE</literal></term>
	  <listitem>
	    <simpara>Indicates this object is sensitive</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_SHOWING</literal></term>
	  <listitem>
	    <simpara> Indicates this object, the object's parent, the
	    object's parent's parent, and so on, are all visible </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_SINGLE_LINE</literal></term>
	  <listitem>
	    <simpara> Indicates this (text) object can contain only a single
	    line of text </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_STALE</literal></term>
	  <listitem>
	    <simpara> Indicates that the index associated with this object
	    has changed since the user accessed the object. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_TRANSIENT</literal></term>
	  <listitem>
	    <simpara>Indicates this object is transient</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_VERTICAL</literal></term>
	  <listitem>
	    <simpara>Indicates the orientation of this object is
	    vertical</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_VISIBLE</literal></term>
	  <listitem>
	    <simpara>Indicates this object is visible</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_MANAGES_DESCENDANTS</literal></term>
	  <listitem>
	    <simpara> 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. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_INDETERMINATE</literal></term>
	  <listitem>
	    <simpara> Indicates that a check box is in a state other than
	    checked or not checked. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_TRUNCATED</literal></term>
	  <listitem>
	    <simpara> Indicates that an object is truncated, e.g. a text
	    value in a speradsheet cell. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_REQUIRED</literal></term>
	  <listitem>
	    <simpara> Indicates that explicit user interaction with an
	    object is required by the user interface, e.g. a required field
	    in a "web-form" interface. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_INVALID_ENTRY</literal></term>
	  <listitem>
	    <simpara> Indicates that the object has encountered 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. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_SUPPORTS_AUTOCOMPLETION</literal></term>
	  <listitem>
	    <simpara> Indicates that the object may exhibit "typeahead"
	    behavior in response to user keystrokes, e.g. one keystroke may
	    result in the insertion of several characters into an entry, or
	    result in the auto-selection of an item in a list. This state
	    supplants <literal>atk.ROLE_AUTOCOMPLETE</literal>. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_SELECTABLE_TEXT</literal></term>
	  <listitem>
	    <simpara>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
	    <literal>atk.STATE_SELECTABLE</literal>, 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. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.STATE_LAST_DEFINED</literal></term>
	  <listitem>
	    <simpara>Not a valid state, used for finding end of
	    enumeration</simpara>
	  </listitem>
	</varlistentry>
      </variablelist>

    </refsect2>

    <refsect2 id="atk-text-attr-constants">
      <title id="atk-text-attr-constants-title">Atk Text Attribute Constants</title>

      <para>The Atk Text Attribute constants specify the built-in text
      attributes supported. Other text attributes may be set by an
      application using the <link
      linkend="function-atk--text-attribute-register"><function>atk.text_attribute_register</function>()</link>
      function.</para>

      <variablelist>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_INVALID</literal></term>
	  <listitem>
	    <simpara>nvalid attribute</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_LEFT_MARGIN</literal></term>
	  <listitem>
	    <simpara>The pixel width of the left margin</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_RIGHT_MARGIN</literal></term>
	  <listitem>
	    <simpara>The pixel width of the right margin</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_INDENT</literal></term>
	  <listitem>
	    <simpara>The number of pixels that the text is indented</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_INVISIBLE</literal></term>
	  <listitem>
	    <simpara>Either "true" or "false" indicating whether text is
	    visible or not</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_PIXELS_ABOVE_LINES</literal></term>
	  <listitem>
	    <simpara>Pixels of blank space to leave above each
	    newline-terminated line.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_PIXELS_BELOW_LINES</literal></term>
	  <listitem>
	    <simpara>Pixels of blank space to leave below each
	    newline-terminated line.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_PIXELS_INSIDE_WRAP</literal></term>
	  <listitem>
	    <simpara>Pixels of blank space to leave between wrapped lines
	    inside the same newline-terminated line (paragraph).</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_BG_FULL_HEIGHT</literal></term>
	  <listitem>
	    <simpara>"true" or "false" whether to make the background color
	    for each character the height of the highest font used on the
	    current line, or the height of the font used for the current
	    character.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_RISE</literal></term>
	  <listitem>
	    <simpara>Number of pixels that the characters are risen above
	    the baseline</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_UNDERLINE</literal></term>
	  <listitem>
	    <simpara>"none", "single", "double" or "low"</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_STRIKETHROUGH</literal></term>
	  <listitem>
	    <simpara>"true" or "false" whether the text is
	    strikethrough</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_SIZE</literal></term>
	  <listitem>
	    <simpara>The size of the characters.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_SCALE</literal></term>
	  <listitem>
	    <simpara>The scale of the characters. The value is a string
	    representation of a double</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_WEIGHT</literal></term>
	  <listitem>
	    <simpara>The weight of the characters.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_LANGUAGE</literal></term>
	  <listitem>
	    <simpara>The language used</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_FAMILY_NAME</literal></term>
	  <listitem>
	    <simpara>The font family name</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_BG_COLOR</literal></term>
	  <listitem>
	    <simpara>The background color. The value is an RGB value of the
	    format "u,u,u"</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_FG_COLOR</literal></term>
	  <listitem>
	    <simpara>The foreground color. The value is an RGB value of the
	    format "u,u,u"</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_BG_STIPPLE</literal></term>
	  <listitem>
	    <simpara>"true" if a <link
	    linkend="class-gdkpixmap"><classname>gtk.gdk.Pixmap</classname></link>
	    is set for stippling the background color.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_FG_STIPPLE</literal></term>
	  <listitem>
	    <simpara>"true" if a <link
	    linkend="class-gdkpixmap"><classname>gtk.gdk.Pixmap</classname></link>
	    is set for stippling the foreground color.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_WRAP_MODE</literal></term>
	  <listitem>
	    <simpara>The wrap mode of the text, if any. Values are "none",
	    "char" or "word"</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_DIRECTION</literal></term>
	  <listitem>
	    <simpara>The direction of the text, if set. Values are "none",
	    "ltr" or "rtl"</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_JUSTIFICATION</literal></term>
	  <listitem>
	    <simpara> The justification of the text, if set. Values are
	    "left", "right", "center" or "fill" </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_STRETCH</literal></term>
	  <listitem>
	    <simpara> The stretch of the text, if set. Values are
	    "ultra_condensed", "extra_condensed", "condensed",
	    "semi_condensed", "normal", "semi_expanded", "expanded",
	    "extra_expanded" or "ultra_expanded" </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_VARIANT</literal></term>
	  <listitem>
	    <simpara> The capitalization variant of the text, if set. Values
	    are "normal" or "small_caps" </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_STYLE</literal></term>
	  <listitem>
	    <simpara> The slant style of the text, if set. Values are
	    "normal", "oblique" or "italic" </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_ATTR_LAST_DEFINED</literal></term>
	  <listitem>
	    <simpara> not a valid text attribute, used for finding end of
	    enumeration </simpara>
	  </listitem>
	</varlistentry>
      </variablelist>

    </refsect2>

    <refsect2 id="atk-text-boundary-constants">
      <title id="atk-text-boundary-constants-title">Atk Text Boundary Constants</title>

      <para>The Atk Text Boundary constants specify oundaries for regions of
      text.</para>

      <variablelist>
	<varlistentry>
	  <term><literal>atk.TEXT_BOUNDARY_CHAR</literal></term>
	  <listitem>
	    <simpara> Boundary is the boundary between characters (including
	    non-printing characters) </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_BOUNDARY_WORD_START</literal></term>
	  <listitem>
	    <simpara>Boundary is the start (i.e. first character) of a
	    word.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_BOUNDARY_WORD_END</literal></term>
	  <listitem>
	    <simpara>Boundary is the end (i.e. last character) of a
	    word.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_BOUNDARY_SENTENCE_START</literal></term>
	  <listitem>
	    <simpara>Boundary is the first character in a
	    sentence.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_BOUNDARY_SENTENCE_END</literal></term>
	  <listitem>
	    <simpara> Boundary is the last (terminal) character in a
	    sentence; in languages which use "sentence stop" punctuation
	    such as English, the boundary is thus the '.', '?', or similar
	    terminal punctuation character. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_BOUNDARY_LINE_START</literal></term>
	  <listitem>
	    <simpara> Boundary is the initial character of the content or a
	    character immediately following a newline, linefeed, or return
	    character. </simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_BOUNDARY_LINE_END</literal></term>
	  <listitem>
	    <simpara>Boundary is the linefeed, or return
	    character.</simpara>
	  </listitem>
	</varlistentry>
      </variablelist>

    </refsect2>

    <refsect2 id="atk-text-clip-type-constants">
      <title id="atk-text-clip-type-constants-title">Atk Text Clip Type Constants</title>

      <para>The Atk Text Clip Type constants specify the type of clipping
      required.</para>

      <variablelist>
	<varlistentry>
	  <term><literal>atk.TEXT_CLIP_NONE</literal></term>
	  <listitem>
	    <simpara>No clipping to be done</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_CLIP_MIN</literal></term>
	  <listitem>
	    <simpara>Text clipped by min coordinate is omitted</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_CLIP_MAX</literal></term>
	  <listitem>
	    <simpara>Text clipped by max coordinate is omitted</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>atk.TEXT_CLIP_BOTH</literal></term>
	  <listitem>
	    <simpara>Only text fully within mix/max bound is
	    retained</simpara>
	  </listitem>
	</varlistentry>
      </variablelist>

    </refsect2>

  </refsect1>

</refentry>