GNOME Accessibility Team

GNU Free Documentation License (GFDL)

gtk_label_set_text()
gtk_button_new_with_label()
gconftool-2 --type bool --set /desktop/gnome/interface/accessibility true
          gnome_program_init(

                         "dialog", "0.1",

                         libgnomeui_module_info_get(),

                                 argc, argv,

                         "app-datadir",

                                 "/usr/local/share",

                         NULL);
Bonobo accessibility support initialized

GTK Accessibility Module initialized

ATK Accessibility Bridge initialized
su - root
rpm --import http://download.fedora.redhat.com/pub/fedora/linux/extras/RPM-GPG-KEY-Fedora-Extras
# missing step to create /etc/yum.repos.d/fedora-extras.repo
yum install gnome-common
su - root
cd /usr/tmp
cvs -d:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome checkout libgail-gnome
cd libgail-gnome
./autogen.sh
make
install -m 444 libgail-gnome.pc /usr/lib/pkgconfig
su - root
cd /usr/local/src
git clone git://git.gnome.org/accerciser
cd accerciser
./autogen.sh
make
make install
yum install pyorbit-devel
su - root
cd /usr/local/src
git clone git://git.gnome.org/orca
cd orca
./autogen.sh
make
make install
  {

     AtkObject *obj;

     obj = gtk_widget_get_accessible (save_button);

     atk_object_set_name (obj, _("Save"));

  }
  {

     AtkObject *obj;

     obj = gtk_widget_get_accessible (save_button);

     atk_object_set_description (obj, _("Saves all the settings and dismisses the dialog."));

  }
  {

     AtkObject *obj;

     obj = gtk_widget_get_accessible (file_save_icon);

     atk_image_set_description (obj, _("Saves this document as a file."));

  }
  import gtk

  def setNameDesc(widget, name=None, description=None):

    '''

    Sets the name, and description (optional), of a GTK+ widget.  Example code:

      setNameDesc(apply_button, 'Apply')

      setNameDesc(up_button, 'Up', 'Move the selected item up")    

    '''

    acc = widget.get_accessible()

    if name is not None:

      acc.set_name(name)  # widget.set_name() is not sufficient

    if description is not None:

      acc.set_description(description)
  {

          GtkWidget *widget;

          [[http://library.gnome.org/devel/gtk/unstable/GtkLabel.html|GtkLabel]] *label;

          AtkObject *atk_widget, *atk_label;

          AtkRelationSet *relation_set;

          AtkRelation *relation;

          AtkObject *targets[1];

          atk_widget = gtk_widget_get_accessible (widget);

          atk_label = gtk_widget_get_accessible (GTK_WIDGET (label));

          relation_set = atk_object_ref_relation_set (atk_label);

          targets[0] = atk_widget;

          relation = atk_relation_new (targets, 1, ATK_RELATION_LABEL_FOR);

          atk_relation_set_add (relation_set, relation);

          g_object_unref (G_OBJECT (relation));

          relation_set = atk_object_ref_relation_set (atk_widget);

          targets[0] = atk_label;

          relation = atk_relation_new (targets, 1, ATK_RELATION_LABELLED_BY);

          atk_relation_set_add (relation_set, relation);

          g_object_unref (G_OBJECT (relation));

  }
  import gtk, atk

  def setRelation(source, atk_relation, *targets):

    '''

    Sets the relation between a GTK+ source widget and one or more GTK+ target

    widgets. Example code:

      import atk, pyatk

      pyatk.setRelation(item, atk.RELATION_LABELLED_BY, item_label)

      pyatk.setRelation(group_label, atk.RELATION_LABEL_FOR, member1, member2)

      pyatk.setRelation(spinner_button, atk.RELATION_CONTROLLER_FOR, spinner)

    For a list and definition of ATK relationships, see: 

    [[http://developer.gnome.org/doc/API/2.0/atk/AtkRelation.html    

    '''

    acc_targets = [] # list of accessible widgets to apply relation attribute

    acc_src = source.get_accessible()

    relation_set = acc_src.ref_relation_set()

    # get a reference to each widget and add to the accessible target list

    for target in targets: 

      acc_targ = target.get_accessible()

      acc_targets.append(acc_targ)

    relation = atk.Relation(acc_targets, 1) # create the relation

    relation.set_property('relation-type', atk_relation)

    relation_set.add(relation) # apply the relation to the target widget(s)
  {

          GtkWidget *widget;

          [[http://library.gnome.org/devel/gtk/unstable/GtkLabel.html|GtkLabel]] *label;

          AtkObject *atk_widget, *atk_label;

          atk_widget = gtk_widget_get_accessible (widget);

          atk_label = gtk_widget_get_accessible (GTK_WIDGET (label));

          atk_object_add_relation (atk_label, ATK_RELATION_LABEL_FOR, atk_widget);

          atk_object_add_relation (atk_widget, ATK_RELATION_LABELLED_BY, atk_label);

  }
  atk_table_set_caption

  atk_table_set_summary 

  atk_table_set_row_description

  atk_table_set_column_description 

  atk_table_set_row_header

  atk_table_set_column_header
  {

  atko = gtk_widget_get_accessible (play_button);               

  AtkAction *action = atk_object_get_action (atko, 0);

  atk_action_set_description (action, _("Plays the selected audio file."));

  }
AtkObject* atk_object_factory_create_accessible
           (AtkObjectFactory *factory, GObject *obj);
static void
newatklib_new_widget_factory_class_init (AtkLibNewWidgetFactoryClass *klass)
{
  AtkObjectFactoryClass *class = ATK_OBJECT_FACTORY_CLASS (klass);
  class-&gt;create_accessible = newatklib_new_widget_factory_create_accessible;
  class-&gt;get_accessible_type = newatklib_new_widget_factory_get_accessible_type;
}
atk_registry_set_factory_type (atk_get_default_registry(), SOME_TYPE_NEW_WIDGET,
                               newatklib_new_widget_factory_get_accessible_type());
get_type()
atk_add_focus_tracker()
  atk_focus_tracker_init (my_focus_tracker_init);
  focus_tracker_id = atk_add_focus_tracker (my_focus_tracker);
_my_focus_tracker()
  static void _my_focus_tracker (AtkObject *aobject);
  mouse_watcher_focus_id =
     atk_add_global_event_listener(_my_global_listener,
     "Gtk:GtkWidget:enter_notify_event");
_my_global_listener
_my_global_listener()
column_inserted
     table_column_inserted_id = g_signal_connect_closure_by_id (my_atk_obj,
     g_signal_lookup ("column_inserted", G_OBJECT_TYPE (my_atk_obj)),
     0, g_cclosure_new (G_CALLBACK (_my_table_column_inserted_func),
     NULL, NULL), FALSE);
_my_table_column_inserted_func()
my_atk_object
children_changed
add
add
  g_signal_emit_by_name (atk_obj, "children_changed::add",
  ((row * n_cols) + column_count), NULL, NULL);
<h1>This is a heading</h1>
<p>
  This is a paragraph with an
  <image src="image.gif"
         alt="some image"/>
  image in it.
</p>
<h2>This is another heading</h2>
(parent AtkText, role=ATK_ROLE_HEADING,
 objattr="xhtml:role=h1",
   text-attributes="css:font-size=LARGER",
   text="This is a heading")
(parent AtkHypertext, role=ATK_ROLE_PARAGRAPH,
 attr="xhtml:role=p"
 text="This is a paragraph with an * image in it")
  (child AtkImage, AtkHyperlink, role=ATK_ROLE_IMAGE,
   ImageDescription ="some image",
   AccessibleName = "" [the HTML title attribute,
     if present]
   hyperlink-range=[28,29])
(parent AtkText, role=ATK_ROLE_HEADING,
   objattr="xhtml-role:h2",
   text-attributes="css:font-size=LARGE",
   text="This is another heading")
<p>Hey!<br>Tell me something.</p>
(parent AtkText, role=ATK_ROLE_PARAGRAPH, attr="xhtml:role=p",
 text="Hey!\nTell me something")
<a href="http://www.google.com">Hey!
<br>Tell me something.</a>
(parent AtkHyperlink, AtkText, role=ATK_ROLE_LINK
 attr="xhtml:role=a;link-type=anchor",
 text="Hey!\nTell me something",
 hyperlink-range=[depends on the containing context],
 hyperlink-URI="http://www.google.com",
 hyperlink-Object=AtkText)
<p>Hey</p><hr/>
<p>Tell me something</p>
(parent1 AtkText, role=ATK_ROLE_PARAGRAPH,
 text="Hey")
(parent2 role=ATK_ROLE_SEPARATOR,
 [note: AtkState doesn't include ATK_STATE_VERTICAL,
       to distinguish from vsep])
(parent3 AtkText, role=ATK_ROLE_PARAGRAPH,
 text="Tell me something")
<p>
  You <em>are</em> a nice person.
</p>
(parent AtkText, role=ATK_ROLE_PARAGRAPH, attr="html:role=p",
 text="You are a nice person",
 attribute run for "are", with textattr="em=true,
css:text-style=oblique")
<p>
  Here is a
  <a href="http://foo.bar.com">
    bartending site
  </a>
 .
</p>
(parent AtkHypertext, role=ATK_ROLE_PARAGRAPH, attr="html:role=p"
  text="Here is a bartending site.",
  attribute run for "bartending site." with textattr="link=true,
  css:text-decoration=underline, css:color=(0,0,255)")
   (child AtkText,  AtkHyperlink,
     role=ATK_ROLE_LINK, attr="html:role=a, link-type:anchor",
     text="bartending site",
     hyperlink-indices=[10,26]
     hyperlink-URI="http://foo.bar.com")
<p>
  Here is a
  <a href="http://foo.bar.com">
    <image src="beerglass.GIF"
           alt="beer glass"/>
    bartending site
  </a>
  .
</p>
(parent AtkHypertext, role=ATK_ROLE_PARAGRAPH,
attr="html:role=p" text="Here is a bartending site."
 attribute run for "bartending site." with textattr="link=true,
  css:text-decoration=underline, css:color=(0,0,255)")
   (child AtkHypertext, AtkHyperlink,
     role=ATK_ROLE_LINK,
     text="*bartending site"
           hypertext-indices=[10,26],
[not sure if we need to dup textattrs here, or add them to defaulttextattrs],
     hypertext-URI="http://foo.bar.com")
         (grandchild AtkImage, AtkHyperlink
           role=ATK_ROLE_IMAGE, attr="html:role=img,
           link-type=image"
           AccName/ImageDescription="beer glass",
           hyperlink-indices=[0,0]
        hyperlink-URI="beerglass.GIF")
[don't know if the URIs should always be fully specified, or if omitting the base URI is OK]
<p>
  Here is a
  <image src="beerglass.GIF"
         alt="beer glass"/>
  <a href="http://foo.bar.com">
    bartending site
  </a>
  .
</p>
(parent AtkHypertext, role=ATK_ROLE_PARAGRAPH, attr="html:role=p",
  text="Here is a *bartending site."}
   {child AtkImage, AtkHyperlink,
     role=ATK_ROLE_IMAGE, attr="html:role=img, link-type=image"
     AccName/ImageDescription="beer glass",
     hyperlink-indices=[10,10]
     hyperlink-URI="beerglass.GIF")
   (child AtkText, AtkHyperlink, AtkAction,
    AtkHypertext, role=ATK_ROLE_LINK,
     action-names="activate", [others?]
     attr="html:role=a, link-type=anchor"
     text="bartending site",
     textattr=[as in above examples]
     hypertext-indices=[10,26],
     hypertext-URI="http://foo.bar.com")
<p>
  <IMG SRC="sitemap.gif"
       ALT="Site map"
       USEMAP="#mymap"></p>
  <MAP name="htmlcat_ibmgapguidecustom.html_mymap" title="site map">
    <AREA href="#htmlcat_1.html" ALT="Bar"
          COORDS="5,5,95,195">
    <AREA href="#htmlcat_2.html" ALT="Baz"
          COORDS="105,5,195,195">
    <AREA href="#htmlcat_3.html" ALT="Fu"
          COORDS="205,5,295,195">
  </MAP>
</p>
(parent AtkHypertext, role=ATK_ROLE_PARAGRAPH,
 text="*")
  (child AtkImage, AtkHypertext,
   role=ATK_ROLE_IMAGE_MAP,
   attr="html:role=map",
   hyperlink-URI="sitemap.gif",
   ImageBounds=[entire map area]
   AccName and ImageDescription="Site map"}
    (grandchild AtkHyperlink, AtkAction,
     action-names="click", role=ATK_ROLE_LINK,
     attr="html:role=area", hyperlink-URI="1.html", name="htmlcat_ibmgapguidecustom.html_Bar")
    (grandchild AtkHyperlink, AtkAction,
     action-names="click", role=ATK_ROLE_LINK,
     attr="html:role=area", hyperlink-URI="2.html", name="htmlcat_ibmgapguidecustom.html_Baz")
    (grandchild AtkHyperlink, AtkAction,
     action-names="click", role=ATK_ROLE_LINK,
     attr="html:role=area", hyperlink-URI="3.html", name="htmlcat_ibmgapguidecustom.html_Fu")
[note that the component bounds of the areas correspond to their rectangular bounding boxes]
<ul>
  <li>This is a list item.</li>
  <li>This is another list item.</li>
</ul>
(parent AtkObject, role=ATK_ROLE_LIST,
   attr="css:list-style-type=disc")
  (child AtkText, role=ATK_ROLE_LIST_ITEM,
   text="This is a list item.",
   attribute run "static" first 2 chars)
  (child AtkText, role=ATK_ROLE_LIST_ITEM,
   text="This is another list item.",
   attribute run "static" first 2 chars)
[we should be able to support list-style=image, and "list-style-image=URL()", etc. this way.
In the above example, it's not clear whether the bullet should be a unicode char
or just omitted and implied by the list style..
my guess is the latter (i.e. bullets don't appear in the text)]
<ol>
  <li>This is a list item.</li>
  <li>This is another list item.</li>
</ol>
(parent AtkObject, role=ATK_ROLE_LIST,
   attr="html:role=ol, css:list-style-type:decimal")
  (child AtkText, role=ATK_ROLE_LIST_ITEM,
   text="1. This is a list item.",
   attribute run "static" first 3 chars)
  (child AtkText, role=ATK_ROLE_LIST_ITEM,
   text="2. This is another list item.",
    attribute run "static" first 3 chars)
[we should clearly define a text attribute which means "this text is
not explicit in the content, but was added by the presentation/user agent. I
believe MSAA/IE uses "static" ?]
<ul>
  <li>
    This is a list item.
    <ul>
      <li>Nested item 1</li>
      <li>Nested item 2</li>
    </ul>
  </li>
  <li>This is another list item.</li>
</ul>
(parent AtkObject, role=ATK_ROLE_LIST,
   attr="html:role=ul, css:list-style-type=disc")
  (child AtkHypertext, role=ATK_ROLE_LIST_ITEM,
   text="This is a list item.*"}
     (grandchild AtkObject, AtkHyperlink, role=ATK_ROLE_LIST,
      attr="html:role=ul, css:list-style-type=circle,
      link-type=child",
      hyperlink-indices=[20,20],
      hyperlink-URI="",
[Hmm, degenerate case here...] )
        (great-grandchild AtkText, role=ATK_ROLE_LIST_ITEM,
          attr="html:role=li" text="Nested item 1")
        (great-grandchild AtkText, role=ATK_ROLE_LIST_ITEM,
           attr="html:role=li" text="Nested item 2")
   (child AtkText, role=ATK_ROLE_LIST_ITEM,
    text="This is another list item.")
[Note that unlike user interface ATK_ROLE_LIST objects, these lists don't
implement AtkSelection, and the list items' AtkStateSets do not include
ATK_STATE_SELECTABLE. There is a question here as to whether <ul> and <ol> elements
should always implement AtkText or not. I think it would be better if they did not, unless they had
non-empty text content, but this may prove impractical.]
<form>
  <div>
    <label for="self"/>
      Tell me a little more:
    </label>
  </div>
  <div>
    <textarea>
      I am a monkey with a long
      tail. I like to swing from
      trees and eat bananas. I've
      recently taken up typing
      and plan to write my memoirs.
    </textarea>
  </div>
</form>
(parent AtkObject, role=ATK_ROLE_FORM, text="")
  (child1 AtkObject, role=ATK_ROLE_SECTION?
[or should we use ATK_ROLE_PANE?]
)
     (grandchild AtkText,
      role=ATK_ROLE_LABEL,
      ATK_RELATION_LABEL_FOR=child2,
      text="Tell me a little more:")
  (child2 role=ATK_ROLE_SECTION?)
    (grandchild AtkEditableText,
     AtkRelation, AtkStateSet, AtkAction,
     ATK_ROLE_ENTRY,
     text="I am a monkey with ..."),
     ATK_RELATION_LABELLED_BY=child1,
     STATE_MULTILINE,
     STATE_REQUIRED allowed)
[ attribute run over the portion of the text scrolled into view?
CONTROLLER_FOR/CONTROLLED_BY for the scrollbar/viewport?
Alternative would be to treat all the text content as though it were visible, but that's no good
for magnifiers and ATs for the mobility-impaired. Probably the textarea needs to be expanded somewhat, or at least fitted with AtkActions for scrolling
plus text attribution for determining what parts of the text are
currently scrolled into view, without the AT client having to resort to bounds checking in the
"screen review" fashion. This is, however, a general problem with multiline text in viewports.
The relatively new AtkText getBoundedRanges API reduces the pain somewhat since you can
feed it the AtkComponent bounds and it will give you back the visible text.]
<form aaa:describedby="checkhelp">
  <p>
    <span
     x2:role="wairole:description"
     id="checkhelp">
        Check one or more:
    </span>
    <input id="cb1" type="checkbox"/>
    <label for="cb1">Red</label>
    <input id="cb2" type="checkbox"/>
    <label for="cb2">Blue</label>
    <input id="cb3" type="checkbox"/>
    <label for="cb3">Green</label>
  </p>
</form>
(parent AtkObject,
 role=ATK_ROLE_FORM,
 attr="html:role=form",
 RELATION_DESCRIBED_BY=grandchild1,
 text="?")
  (child AtkText,
   role=ATK_ROLE_PARAGRAPH, attr="html:role=p", text="")
    (grandchild1 AtkText,
     role=ATK_ROLE_LABEL,
     RELATION_DESCRIPTION_FOR=parent,
     attr="html:role=wairole:description")
     text="Check one or more:"}
    (grandchild2 AtkAction,
     AtkStateSet, role=ATK_ROLE_CHECK_BOX,
     attr="html:role=input",
[and same with other elements, expose html:role]
[note also that these objects do NOT have accessible names, because they are labelled;
accessible-name would presumably come from the HTML title attribute or other attribute.
This is mainly to make it easier for ATs to avoid highly redundant speech in these cases.]
     ATK_RELATION_LABELLED_BY=grandchild3)
    (grandchild3 AtkText,
     role=ATK_ROLE_LABEL, text="Red",
     ATK_RELATION_LABEL_FOR=grandchild2)
    (grandchild4 AtkAction,
     AtkStateSet, role=ATK_ROLE_CHECK_BOX,
     ATK_RELATION_LABELLED_BY=grandchild5)
    (grandchild5 AtkText,
     role=ATK_ROLE_LABEL, text="Blue",
     ATK_RELATION_LABEL_FOR=grandchild4)
    (grandchild6 AtkAction,
     AtkStateSet, role=ATK_ROLE_CHECK_BOX,
     ATK_RELATION_LABELLED_BY=grandchild7)
    (grandchild7 AtkText,
     role=ATK_ROLE_LABEL, text="Green",
     ATK_RELATION_LABEL_FOR=grandchild6)
[RFE: add ATK_RELATION_DESCRIBED_BY
and ATK_RELATION_DESCRIPTION_FOR to match MSAA/DHTML.
Also, I thought we had ATK_ROLE_FORM, but it seems not to be there.
Did I miss something?]
<form>
  <label for="beverage">
    Make a selection:
  </label>
  <select id="beverage">
    <option>Water</option>
    <option>Wine</option>
    <option>Whiskey</option>
  </select>
</form>
(parent role=ATK_ROLE_FORM?)
  (child AtkText,
   role=ATK_ROLE_LABEL,
   ATK_RELATION_LABEL_FOR=child,
   text="Make a selection:")
  (child AtkAction,
   AtkStateSet, AtkSelection,
   attr="html:role=select",
   role=ATK_ROLE_COMBO_BOX,
   ATK_RELATION_LABELLED_BY)
       {grandchild,
        AtkText,
        AtkStateSet=...SELECTABLE, SELECTED...,
        attr="html:role=option",
        role=ATK_ROLE_LIST_ITEM, text="Water")
       (grandchild,
        AtkText,
        AtkStateSet=...SELECTABLE...,
        attr="html:role=option",
        role=ATK_ROLE_LIST_ITEM, text="Wine")
       (grandchild AtkText,
        AtkStateSet=...SELECTABLE...,
        role=ATK_ROLE_LIST_ITEM,
        attr="html:role=option",
        text="Whiskey")
[note that because the entry field is not editable, but just displays the current
selection, I think it should not be exposed (especially since it represents a node
 which is not present in the HTML DOM. The list items need not implement AtkAction,
since the AtkSelection interface is used by the client to select among them.]
<form>
  <label for="sports">
    Which sports do you like:
    <br>
    <select id="sports"
            multiple="multiple"
            size="3">
      <option>
        <img src="beerglass.gif"
             alt="Beer"/>
        Baseball
      </option>
      <option>Basketball</option>
      <option>Football</option>
    </select>
  </label>
</form>
(parent role=ATK_ROLE_FORM?)
  (child1 AtkText,
   role=ATK_ROLE_LABEL,
   ATK_RELATION_LABEL_FOR=child2,
   text="Which sports do you like:\n*")
  (child2 AtkObject,
   accessible-name="htmlcat_ibmgapguidecustom.html_sports"
[not sure exposing the id is a good idea though],
   AtkSelection,
   AtkStateSet=...MULTISELECT...
   attr="html:role=select",
   role=ATK_ROLE_LIST,
   ATK_RELATION_LABELLED_BY=child2)
       (grandchild1,
        AtkHyperText,
        AtkStateSet=...SELECTABLE, SELECTED...,
        attr="html:role=option",
        role=ATK_ROLE_LIST_ITEM, text="*Baseball")
          (great-grandchild AtkImage, AtkHyperlink,
           role=ATK_ROLE_IMAGE,
           attr="html:role=img, link-type=image",
           hyperlink-URI="beerglass.gif",
           hyperlink-indices=[0,0])
       (grandchild2,
        AtkText,
        AtkStateSet=...SELECTABLE...,
        attr="html:role=option",
        role=ATK_ROLE_LIST_ITEM, text="Basketball")
       (grandchild3 AtkText,
        AtkStateSet=...SELECTABLE...,
        role=ATK_ROLE_LIST_ITEM,
        attr="html:role=option",
        text="Football")
gtk_label_new_with_mnemonic

gtk_label_set_mnemonic_widget

gtk_radio_button_new_with_mnemonic
gtk_widget_get_accessible

atk_object_set_name

atk_object_set_description

atk_image_set_name

atk_image_set_description

gtk_tooltips_set_tip
gtk_widget_get_accessible

atk_object_ref_relation_set

atk_relation_type_for_name

atk_relation_new

atk_relation_set_add
"object:state-changed:selected"
"object:state-changed:selected"
obj
component
component
component
component
x
y
type
type
NULL
NULL
name
link_
link_
i
link_
TRUE
FALSE
FALSE
TRUE
component
x
y
component
component
start_pos
end_pos
start_pos
end_pos
start_pos
end_pos
start_pos
end_pos
width
height
width
height
name
row
column
row
column
index_
index_
table
column
column
table
row
column
table
header
row
column
table
header
column
row
row
column
row
column
row
column
offset
start_offset
end_offset
offset
name
x
y
x
y
coords
offset
link_index
char_index

Widget	GAIL Implementation	GAIL Inheritance	ATK Interfaces	ATK_ROLE
GtkWidget	GailWidget		AtkComponent, AtkObject, AtkStateSet, AtkRelationSet, AtkRelation	(base class) ATK_ROLE_UNKNOWN
GtkLabel	GailLabel	GailWidget	AtkObject, AtkText (AtkAttributeSet), AtkStateSet, AtkRelationSet	ATK_ROLE_LABEL
GtkAccelLabel		GailLabel		ATK_ROLE_ACCEL_LABEL
GtkArrow	GailArrow	GailWidget	AtkObject, AtkImage	ATK_ROLE_ICON
GtkImage	GailImage	GailWidget	AtkObject, AtkComponent, AtkImage	ATK_ROLE_ICON
GtkContainer	GailContainer	GailWidget	AtkObject	ATK_ROLE_UNKNOWN or ATK_ROLE_PANEL
GtkViewPort		GailContainer		ATK_ROLE_VIEWPORT
GtkToolbar		GailContainer		ATK_ROLE_TOOLBAR
GtkScrolledWindow	GailScrolledWindow	GailContainer	AtkObject	ATK_ROLE_SCROLL_PANE
GtkFrame	GailFrame	GailWidget	AtkObject	ATK_ROLE_PANEL
GtkButton	GailButton	GailWidget	AtkObject, AtkComponent, AtkAction, AtkImage (if an image), AtkText (AtkAttributeSet), AtkStateSet	ATK_ROLE_PUSH_BUTTON or ATK_TABLE_COLUMN_HEADER (if tree view)
GtkToggleButton	GailToggleButton	GailButton	AtkObject, AtkAction, AtkStateSet	ATK_ROLE_TOGGLE_BUTTON
GtkCheckButton		GailToggleButton		ATK_ROLE_CHECK_BOX
GtkRadioButton	GailRadioButton	GailToggleButton	AtkObject, AtkRelationSet, AtkRelation	ATK_ROLE_RADIO_BUTTON
GtkExpander	GailExpander	GailContainer	AtkObject, AtkText (AtkAttributeSet), AtkAction, AtkStateSet	ATK_ROLE_TOGGLE_BUTTON
GtkItem	GailItem	GailContainer	AtkObject, AtkText (AtkAttributeSet)	ATK_ROLE_LIST_ITEM
GtkMenuItem	GailMenuItem	GailWidget	AtkObject, AtkAction	ATK_ROLE_MENU_ITEM
GtkSeparatorMenuItem		GailMenuItem		ATK_ROLE_SEPARATOR
GtkTearOffMenuItem		GailMenuItem		ATK_ROLE_TEAR_OFF_MENU_ITEM
GtkCheckMenuItem	GailCheckMenuItem	GailMenuItem	AtkObject, AtkStateSet	ATK_ROLE_CHECK_MENU_ITEM
GtkRadioMenuItem	GailRadioMenuItem	GailCheckMenuItem	AtkObject, AtkRelationSet	ATK_ROLE_RADIO_MENU_ITEM
GtkMenuShell	GailMenuShell	GailContainer, GailWidget	AtkObject, AtkSelection	ATK_ROLE_MENU_BAR
GtkMenu	GailMenu	GailMenuShell	AtkObject	ATK_ROLE_MENU
GtkMenuBar		GailMenuShell		ATK_ROLE_MENU_BAR
GtkWindow	GailWindow	GailWidget	AtkObject, AtkComponent, AtkRelation, AtkRelationSet, AtkStateSet	ATK_ROLE_WINDOW or ATK_ROLE_PANEL or ATK_ROLE_FRAME
GtkDialog		GailWindow		ATK_ROLE_DIALOG
GtkColorSelectionDialog		GailWindow		ATK_ROLE_COLOR_CHOOSER
GtkFileSelection		GailWindow		ATK_ROLE_FONT_CHOOSER
GtkColorSelection		GailWindow		ATK_ROLE_COLOR_CHOOSER
GtkFontSelection		GailWindow		ATK_ROLE_FONT_CHOOSER
GtkFontSelectionDialog		GailWindow		ATK_ROLE_DIALOG
GtkMessageDialog		GailWindow		ATK_ROLE_ALERT
GtkHandleBox		GailWindow		ATK_ROLE_WINDOW
GtkTooltips		GailWindow		ATK_ROLE_TOOL_TIP
GtkBox	GailBox	GailContainer	AtkObject, AtkStateSet	ATK_ROLE_FILLER
GtkButtonBox		GailBox		ATK_ROLE_FILLER
GtkHButtonBox		GailBox		ATK_ROLE_FILLER
GtkVButtonBox		GailBox		ATK_ROLE_FILLER
GtkHBox		GailBox		ATK_ROLE_FILLER
GtkComboBox	GailComboBox	GailContainer	AtkObject, AtkAction, AtkSelection	ATK_ROLE_COMBO_BOX
GtkStatusBar	GailStatusBar	GailContainer	AtkObject, AtkText (AtkAttributeSet)	ATK_ROLE_STATUSBAR
GtkFixed		GailContainer		ATK_ROLE_UNKNOWN
GtkPaned		GailContainer		ATK_ROLE_UNKNOWN
!GtkHPaned		GailContainer		ATK_ROLE_UNKNOWN
GtkVpaned		GailContainer		ATK_ROLE_UNKNOWN
GtkLayout		GailContainer		ATK_ROLE_UNKNOWN
GtkPacker		GailContainer		ATK_ROLE_UNKNOWN
GtkTable		GailContainer		ATK_ROLE_UNKNOWN
GtkNotebook	GailNotebook	GailWidget	AtkObject, AtkSelection	ATK_ROLE_PAGE_TAB_LIST
GtkTreeView	GailTreeView	GailContainer	AtkObject, AtkComponent, AtkTable, AtkSelection, AtkRegistry, AtkObjectFactory, AtkRelationSet, AtkRelation, AtkStateSet	ATK_ROLE_TREE_TABLE or ATK_ROLE_TABLE or ATK_ROLE_UNKNOWN
GtkCellRenderer	GailRendererCell	GailWidget	AtkObject	ATK_ROLE_TABLE_CELL
GtkCellRendererText	GailTextCell	GailWidget	AtkObject, AtkText (AtkAttributeSet)	ATK_ROLE_TABLE_CELL
GtkCellRendererToggle	GailBooleanCell	GailWidget	AtkObject	ATK_ROLE_TABLE_CELL
GtkCellRendererPixbuf	GailImageCell	GailWidget	AtkObject, AtkImage, AtkComponent	ATK_ROLE_TABLE_CELL
GtkTextView	GailTextView	GailContainer	AtkObject, AtkEditableText, AtkText (AtkAttributeSet), AtkStateSet (Why not AtkHyperlink and AtkHypertext for when there are links and AtkTable for when there's a table?)	ATK_ROLE_TEXT
GtkCalendar	GailCalendar	GailWidget	AtkObject (Why not AtkSelection?)	ATK_ROLE_CALENDAR
GtkEntry	GailEntry	GailWidget	AtkObject, AtkEditableText, AtkText (AtkAttributeSet), AtkRelation, AtkRelationSet, AtkStateSet, AtkAction	ATK_ROLE_TEXT or ATK_PASSWORD_TEXT
GtkSpinButton	GailSpinButton	GailWidget	AtkObject, AtkValue	ATK_ROLE_SPIN_BUTTON
GtkRange	GailRange	GailWidget	AtkObject, AtkValue, AtkStateSet	ATK_ROLE_SLIDER
GtkScale	GailScale	GailRange	AtkObject, AtkText (AtkAttributeSet)	(base class)
GtkHScale		GailScale
GtkVScale		GailScale
GtkScrollbar	GailScrollbar	GailRange	AtkObject	ATK_ROLE_SCROLLBAR (base class)
GtkHScrollbar		GailScrollBar
GtkVScrollbar		GailScrollBar
GtkSeparator	GailSeparator	GailWidget	AtkObject, AtkStateSet	ATK_ROLE_SEPARATOR (base class)
GtkHSeparator		GailSeparator
GtkVSeparator		GailSeparator
GtkProgressbar	GailProgressBar	GailWidget	AtkObject, AtkValue	ATK_ROLE_PROGRESS_BAR
GtkAdjustment	GailAdjustment	GailWidget	AtkObject, AtkValue	ATK_ROLE_UNKNOWN

Function	Microsoft Windows	GNOME
Close document	None	Ctrl + W
Close application	Alt + F4	Ctrl + Q
Find next	F3	Ctrl + G
Go to	Ctrl + G	None?
Rename	None	F2
Repeat	Ctrl + Y	None?
Invert selection	None	Ctrl + I
Refresh/reload	F5	Ctrl + R
Add bookmark/favorite	None	Ctrl + D
Location (URL address)	Ctrl + O, or F4	Ctrl + L
Switch panels	Ctrl + Tab	Ctrl + Alt + Tab
Restore	None	Alt + F5
Switch secondary windows	F6	Alt + F6
Move	None	Alt + F7
Resize	None	Alt + F8
Minimize	None	Alt + F10
Maximize	None	Alt + F10
Full screen	F11	Ctrl + F11
Tooltips/context sensitive help	F1	Ctrl + F1 or Shift + F1
Menubar focus	Alt or F10	F10 but not Alt

Keyboard Mappings	Mobility Access Feature
5 consecutive clicks of Shift key	On/Off for StickyKeys
Shift key held down for 8 seconds	On/Off for SlowKeys
Others?

Class	Major	Minor	Detail	detail1	detail2	any_data
focus
window	create					string: title
	close					string: title
	minimize					string: title
	maximize					string: title
	restore					string: title
	reparent
	desktop-create
	desktop-destroy
	activate					string: title
	deactivate					string: title
	raise					string: title
	lower					string: title
	move					string: title
	resize					string: title
	shade					string: title
	unshade					string: title
	restyle					string: title
object	text-caret-moved			int: new caret index
	text-changed	inserted		int: start of inserted text	int: end of inserted text	string: inserted text
	text-changed	removed		int: start of deleted text	int: end of deleted text	string: deleted text
	text-selection-changed
	text-attributes-changed
	property-change	accessible-parent				object: new parent
		accessible-name				string: new name
		accessible-description				string: new description
		accessible-value
		accessible-role
		accessible-table-caption
		accessible-table-column-description
		accessible-table-column-header
		accessible-table-row-description
		accessible-table-row-header
		accessible-table-summary
	state-changed	*		bool: state set or state unset
	children-changed	add		int: child index **		object: added child **
	children-changed	remove		int: child index **		object: added child **
	visible-data-changed
	bounds-changed
	selection-changed
	row-inserted			int: index of first row	int: number of rows
	row-reordered
	row-deleted			int: index of first row	int: number of rows
	column-inserted			int: index of first column	int: number of columns
	column-reordered
	column-deleted			int: index of first column	int: number of columns
	model-changed
	active-descendant-changed			int: descendant index		object: descendant
	attributes-changed
	link-selected
document	load-complete
	reload
	load-stopped
	content-changed
	attributes-changed
terminal	line-changed
	columncount-changed
	linecount-changed
	application-changed
	charwidth-changed
mouse	abs			int: x	int: y
	rel			int: delta x	int: delta y
	button	1p		int: x	int: y
		1r		int: x	int: y
		2p		int: x	int: y
		2r		int: x	int: y
		3p		int: x	int: y
		3r		int: x	int: y

MSAA 1.3 Role (ROLE_SYSTEM_ *)	IAccessible2 Role (IA2_ROLE_*)	CLOSEST ATK Role(s) (ATK_ROLE_*)	Also implement these ATK Interfaces	Potential ATK states in addition to general states (ATK_STATE_*)	Description
ALERT		ALERT	AtkObject, AtkComponent, AtkRelation, AtkRelationSet, AtkStateSet	ACTIVE, ICONIFIED, MODAL, RESIZABLE	An error, warning, or informational message
ANIMATION		ANIMATION	AtkObject, AtkComponent, AtkImage	ANIMATED	A dynamic or moving image that changes over time.
APPLICATION		APPLICATION	AtkObject, AtkComponent, AtkRelation, AtkRelationSet, AtkStateSet		Toplevel accessible object of an application, which may contain frame objects or other accessible objects.
BORDER		don't use			Window border as an object
BUTTONDROPDOWN		add custom role	AtkObject, AtkComponent, AtkAction, AtkImage (if button is an image), AtkText (AtkAttributeSet), AtkStateSet, AtkSelection	ACTIVE, ARMED, EXPANDED, EXPANDABLE, COLLAPSED, MANAGES_DESCENDANTS, MULTISELECTABLE, PRESSED, REQUIRED	Button that drops down a list of items
BUTTONDROPDOWNGRID		add custom role	AtkObject, AtkComponent, AtkAction, AtkImage (if button is an image), AtkText (AtkAttributeSet), AtkStateSet, AtkSelection, AtkTable (if row/column headers)	ACTIVE, ARMED, EXPANDED, EXPANDABLE, COLLAPSED, MANAGES_DESCENDANTS, MULTISELECTABLE, PRESSED, REQUIRED	Button that drops down a grid
BUTTONMENU		add custom role	AtkObject, AtkComponent, AtkAction, AtkImage (if button is an image), AtkText (AtkAttributeSet), AtkStateSet, AtkSelection	ACTIVE, ARMED, EXPANDED, EXPANDABLE, MANAGES_DESCENDANTS, PRESSED	Button that drops down a menu
CARET		don't use			System caret
CELL		TABLE_CELL	AtkObject, AtkText (if it contains text), AtkImage (if it contains an image), AtkComponent (if it contains an image)	SINGLE_LINE, MULTI_LINE TRANSIENT, SELECTABLE, SELECTED, STALE, EDITABLE, INVALID_ENTRY, SELECTABLE_TEXT, REQUIRED, SUPPORTS_TYPEAHEAD, TRUNCATED	Cell in a table
CHARACTER		don't use			Paperclip character.
CHART		CHART (proposed)?	AtkObject, AtkComponent, AtkImage		Graphical depiction of quantitative data
CHECKBUTTON	CHECK_MENU_ITEM, TOGGLE_BUTTON	CHECK_BOX, CHECK_MENU_ITEM, TOGGLE_BUTTON	AtkObject, AtkAction, AtkStateSet. AtkSelection (if in a menu item), AtkRelation and AtkRelationSet (if text label not part of widget)	ACTIVE, ARMED, CHECKED, SELECTABLE, SELECTED, INDETERMINATE,, EXPANDABLE. INVALID	Choice that can be checked or unchecked. CHECK_BOX is most like CHECKBUTTON. A checkbox and check menu item have a separate indicator for the state. A toggle button is a specialized push button that does not have a separate indicator for the state.
CLOCK		add custom role	For digital clock, see SPINBUTTON. For analog clock, see DIAL?		Clock object.
COLUMN		don't use			Column of table cells.
COLUMNHEADER		TABLE_COLUMN_HEADER, COLUMN_HEADER	AtkObject, AtkTable		Header which labels a column of data, or more specifically a column of data in a table.
COMBOBOX		COMBO_BOX	AtkObject, AtkAction, AtkSelection, AtkEditableText (if you can type text as well as select item), AtkText (AtkAttributeSet), AtkRelation (to associate a text label with the control), AtkRelationSet, AtkStateSet	ACTIVE, EXPANDED, EXPANDABLE, COLLAPSED, MANAGES_DESCENDANTS, MULTISELECTABLE, INVALID_ENTRY, EDITABLE, SELECTABLE_TEXT, REQUIRED, SUPPORTS_TYPEAHEAD	Edit control with a drop-down list of selections
CURSOR		don't use			Mouse pointer.
DIAGRAM		IMAGE, DRAWING_AREA, or add custom role	AtkObject, AtkComponent, AtkImage		Image is a generic graphic. Diagram is a specific type of a drawn graphic. Drawing area is used for creating custom user interface elements. Need to address this whole type of role later.
DIAL		DIAL	AtkObject, AtkValue, AtkStateSet, AtkAction		Control with value changes using a rotating visual indicator
DIALOG	COLOR_CHOOSER, FILE_CHOOSER, FONT_CHOOSER	DIALOG, COLOR_CHOOSER, FILE_CHOOSER, FONT_CHOOSER	AtkObject, AtkComponent, AtkRelation, AtkRelationSet, AtkStateSet	ACTIVE, ICONIFIED, MODAL, RESIZABLE	Top level window with a title bar and border. A file chooser is a specialized dialog that displays files in a directory and allows file selection, directory browsing, and filename specification. A color chooser is a specialized dialog for choosing a color.
DOCUMENT	TEXT_FRAME	HTML_CONTAINER or DOCUMENT_FRAME	AtkObject, AtkComponent and AtkImages for embedded images, AtkRelation and AtkRelationSet for relationships between text and embedded objects, AtkStateSet, AtkDocument, AtkText (AtkAttributeSet), AtkHypertext and AtkHyperlink for interactive elements plus non-link images, AtkAction for interactive elements, AtkTable for all data tables, AtkSelection for embedded objects with children	EDITABLE, MULTI_LINE, SELECTABLE_TEXT, BUSY	For MSAA, a document is a window that corresponds to MDI document. An HTML container or document frame is an HTML document or a frame containing a view of document content.
DROPLIST		add custom role or COMBO_BOX	AtkObject, AtkAction, AtkSelection, AtkRelation (to associate a text label with the control), AtkRelationSet, AtkStateSet	ACTIVE, EXPANDED, EXPANDABLE, COLLAPSED, MANAGES_DESCENDANTS, MULTISELECTABLE, REQUIRED	Drop down list but not a combo box
EQUATION		add custom role	AtkObject, AtkText (AtkAttributeSet)		Math and chemistry equations
GRAPHIC	DESKTOP_ICON, SHAPE, ICON	IMAGE, DESKTOP_ICON, ICON	AtkObject, AtkComponent, AtkImage		Desktop icon is an inconifed internal frame within a DESKTOP_PANE Icon is small fixed size picture, typically used to decorate components Graphic is an image. Shape is an object with graphical representation used to represent content on draw pages.
GRIP			AtkObject, AtkImage		An object that can be moved to resize a pane
GROUPING		PANEL, PAGE (proposed), SECTION (proposed)	AtkObject, AtkRelation, AtkRelationSet	VERTICAL, HORIZONTAL	Container used to group objects, like a group box or a FIELDSET in HTML. A page is defined for documents. A section is a generic container of content within a document, such as a navigation bar, table of contents, main content section, content between headings, etc.
HELPBALLOON		don't use	AtkObject, AtkImage		Help icon to click on to get tooltip help
HOTKEYFIELD		add custom role	AtkObject, AtkAction, AtkSelection (if you can select from a drop-down list), AtkEditableText (if you can type text as well as select item), AtkText (AtkAttributeSet), AtkRelation (to associate a text label with the control), AtkRelationSet, AtkStateSet	ACTIVE, EDITABLE, MULTI_LINE, SINGLE_LINE, MULTISELECTABLE, INVALID_ENTRY, SELECTABLE_TEXT, REQUIRED, SUPPORTS_TYPEAHEAD	Editable field for assigning keys
INDICATOR		ARROW or add custom role	AtkObject, AtkImage		An indicator is a graphic, like an arrow, used to indicate something. Arrow is a 2D directional indicator.
LINK		LINK	AtkObject, AtkHyperlink, AtkHypertext, AtkImage and AtkComponent (if an image), AtkAction AtkText (to expose text attributes like visited)		Hypertext link in a document that can be an image or text
LIST		LIST	AtkObject, AtkAction, AtkSelection, AtkRelation (to associate a text label with the control), AtkRelationSet, AtkStateSet	ACTIVE, MANAGES_DESCENDANTS, MULTISELECTABLE, REQUIRED	List of objects that allows one or more selections. A font chooser allows selection of a display font.
LISTITEM		LISTITEM	AtkObject, AtkText (AtkAttributeSet)	SELECTABLE, SELECTED	Element in a selectable list
MENUBAR		MENU_BAR	AtkObject, AtkSelection	ACTIVE, MANAGES_DESCENDANTS	Object drawn at the top of the primary window or dialog box of an application ((just below the title bar)) that contains a list of menus.
MENUITEM	RADIO_MENU_ITEM CHECK_MENU_ITEM	MENU_ITEM, RADIO_MENU_ITEM, CHECK_MENU_ITEM, MENU	AtkObject, AtkAction, AtkStateSet, AtkRelationSet (if radio menu item)	SELECTABLE, SELECTED	Element in a menu that presents a selectable action. A radio menu item is both a radio button and a menu item. A check menu item is both a check box and a menu item. A menu item with a submenu has a role of ATK_ROLE_MENU in ATK. A menu is a list of actions from which the user can choose.
MENUPOPUP		POPUP_MENU, TEAROFF_MENU_ITEM?	AtkObject, AtkAction, AtkComponent, AtkSelection	ACTIVE, MANAGES_DESCENDANTS	A pop-up menu is a temporary window that offers the user a list of choices, then hides itself once the user selects one of those choices. A tearoff menu item is a is a menu that can be removed from the menubar and shown in its own window.
OUTLINE		TREE, TREE_TABLE	AtkObject, AtkComponent, AtkTable, AtkSelection, AtkRegistry, AtkObjectFactory, AtkRelationSet, AtkRelation, AtkStateSet, AtkAction	ACTIVE, MANAGES_DESCENDANTS, EXPANDED, COLLAPSED, EXPANDABLE, MULTISELECTABLE	A tree or an outline is an object used to present hierarchical information to the user, usually with expandable/collapsable elements. A tree table presents both tabular and hierarchical information to the user.
OUTLINEITEM		use custom role	AtkObject, AtkText (AtkAttributeSet)	SELECTABLE, SELECTED	A tree item.
PAGETAB		PAGE_TAB	AtkObject, AtkText (AtkAttributeSet), AtkRelationSet, AtkRelation	SELECTABLE, SELECTED	A tab that usually contains a label or title for a page or panel of a notebook container.
PAGETABLIST		PAGE_TAB_LIST	AtkObject, AtkSelection, AtkAction	ACTIVE, SELECTABLE, SELECTED	A tabbed notebook container, or a series of panels presented as tabbed pages.
PANE	GLASS_PANE, LAYERED_PANE, OPTION_PANE, SCROLL_PANE, DIRECTORY_PANE, ROOT_PANE, SPLIT_PANE, VIEWPORT	GLASS_PANE, LAYERED_PANE, OPTION_PANE, SCROLL_PANE, DIRECTORY_PANE, ROOT_PANE, SPLIT_PANE, VIEWPORT	AtkObject	ACTIVE, RESIZABLE	A pane in the current window. A glass pane is painted on top of all panes beneath it. A layered pane allows its children to be drawn in layers based on a stacking order. An option pane is a pane inside of a dialog. A scroll pane contains scroll bars. A directory pane contains selections (icons, lists, trees) for the content of a directory. A root pane has a glass pane and a layered pane as its children. A split pane is a panel that presents two other panels at the same time. A viewport is a container of content, usually used in a scroll pane, that represents a clipped version of that pane that is onscreen (visible).
PROGRESSBAR		PROGRESS_BAR	AtkObject, AtkValue	BUSY, VERTICAL, HORIZONTAL	Object that shows the percentage of a task that has completed.
PROPERTYPAGE		PAGE_TAB_LIST or add custom role?	AtkObject, AtkComponent, AtkRelation, AtkRelationSet, AtkStateSet	ACTIVE, RESIZABLE	Page showing properties of something. An object that presents a series of panels (or page tabs), one at a time, through some mechanism provided by the object
PUSHBUTTON		PUSH_BUTTON	AtkObject, AtkComponent, AtkAction, AtkImage (if an image), AtkText (AtkAttributeSet), AtkStateSet	ACTIVE, ARMED, PRESSED	A push button tells the application to do something when it is activated.
RADIOBUTTON	RADIO_MENU_ITEM	RADIO_BUTTON, RADIO_MENU_ITEM	AtkObject, AtkRelationSet, AtkRelation, AtkAction	ACTIVE, ARMED, CHECKED	Usually in a group, only one radio button in a group can be "checked". Check one radio button causes all others in the group to be unchecked. A radio menu item is both a radio button and a menu item.
ROW		don't use	AtkObject, AtkTable		Row in a table.
ROWHEADER		ROW_HEADER, TABLE_ROW_HEADER	AtkObject, AtkTable		Header which labels a row of data, or more specifically a row of data in a table.
SCROLLBAR		SCROLL_BAR	AtkObject, AtkValue	BUSY, VERTICAL, HORIZONTAL	Object which allows a user to incrementally view a large amount of data by moving the bounds of a viewport along a one-dimensional axis.
SEPARATOR		SEPARATOR	AtkObject, AtkStateSet	VERTICAL, HORIZONTAL	Object that provides a visual separation of contents in a menu or between 2 areas/panes.
SLIDER		SLIDER	AtkObject, AtkValue, AtkStateSet, AtkAction	BUSY, VERTICAL, HORIZONTAL	Object that allows the user to select or adjust a value in increments from a bounded range of minimum to maximum values.
SOUND		IMAGE, ICON, or add custom control?	AtkObject, AtkComponent, AtkImage		System sound object.
SPINBUTTON		SPIN_BUTTON	AtkObject, AtkValue, AtkRelation, AtkRelationSet, AtkAction	REQUIRED	Object that allows the user to select a value from a set of choices.
STATICTEXT	LABEL	LABEL, ACCELERATOR_LABEL	AtkObject, AtkText (AtkAttributeSet), AtkRelation, AtkRelationSet, AtkStateSet, AtkAction (keybindings)	MULTI_LINE, SINGLE_LINE	A label presents text that provides a short name or description associated with another object, like a text entry field. An accelerator label indicates the keyboard accelerators for its parent, like a menu item.
STATUSBAR		STATUS_BAR	AtkObject, AtkText (AtkAttributeSet)		Display non-quantitative status information, in contrast to a progress bar which displays quantitative status.
TABLE		TABLE, CALENDAR, TREE_TABLE	AtkObject, AtkComponent, AtkTable, AtkSelection, AtkRegistry, AtkObjectFactory, AtkRelationSet, AtkRelation, AtkStateSet	ACTIVE, MANAGES_DESCENDANTS, EXPANDABLE, EXPANDED, COLLAPSED	Presents information in terms of rows and columns. A calendar contains one or more dates, usually arranged in a tabular format, but not always. A tree table presents information in both a tabular and hierarchical format.
TEXT	DATE_EDITOR, PARAGRAPH, HEADING, HEADER, FOOTER, CAPTION	TEXT, DATE_EDITOR, PASSWORD_TEXT, AUTOCOMPLETE, <Should deprecate due to new state> ENTRY, PARAGRAPH, HEADING, HEADER, FOOTER, CAPTION	AtkObject, AtkText (AtkAttributeSet), AtkRelation, AtkRelationSet, AtkStateSet, AtkEditableText (if editable), AtkAction	MULTI_LINE, SINGLE_LINE, EDITABLE, INVALID_ENTRY, SELECTABLE_TEXT, REQUIRED, SUPPORTS_AUTOCOMPLETION	Text information in general. A date editor allows entry of a date. A password text entry object shows nothing or an alternative character, like an asterisk, when the password text is typed. Autocomplete is a dialog or list containing items for insertion into an entry widget, such as a list of words or characters for completion of a text entry. Entry is a text entry field which may be editable or read-only depending on the STATE_EDITABLE attribute. A paragraph is a paragraph of text in a document. A heading is the title for a section in a document. A header is a section at the top of a document, or the top of each page in a document. A footer is a section at the bottom of a document, or the bottom of each page of a document. A caption is descriptive information, usually textual, about another user interface element such as a table, chart, or image.
TITLEBAR		add custom role	AtkObject, AtkText (AtkAttributeSet), AtkRelation, AtkRelationSet, AtkStateSet		Title or caption of a window or dialog.
TOOLBAR		TOOL_BAR	AtkObject, AtkSelection		A bar or palette usually comprised of push buttons or toggle buttons.
TOOLTIP		TOOL_TIP	AtkObject, AtkText (AtkAttributeSet)t, AtkRelation, AtkRelationSet	HAS_TOOLTIP (for object that has the tooltip)	An object that provides descriptive or helpful information about another object, often when the help key is pressed or the mouse moves over an object.
WHITESPACE		FILLER	AtkObject, AtkText (AtkAttributeSet)	VERTICAL, HORIZONTAL	Object that takes up space in a user interface.
WINDOW	FRAME, INTERNAL_FRAME, DESKTOP_PANE	WINDOW, FRAME, INTERNAL_FRAME, DESKTOP_FRAME	AtkObject, AtkComponent, AtkRelation, AtkRelationSet, AtkStateSet	ACTIVE, ICONIFIED, RESIZABLE	A top level window with no title or border. A frame is a top level window with a title bar, border, menubar, etc. An internal frame is a frame clipped by a desktop frame. A desktop frame is a pane that supports internal frames and icons for those internal frames.
	RULER	RULER	AtkObject, AtkImage, AtkComponent, AtkValue		Object that describes margins and tab stops.
	EMBEDDED_OBJECT	EMBEDDED	AtkObject		Object that is an embedded component container in a document.
	EDITBAR	EDITBAR	AtkObject, AtkText (AtkAttributeSet), AtkRelation, AtkRelationSet, AtkStateSet, AtkEditableText, AtkAction	MULTI_LINE, SINGLE_LINE, EDITABLE, INVALID_ENTRY, SUPPORTS_AUTOCOMPLETION	Object that is an editable text object in a toolbar.
CLIENT		CANVAS	AtkObject, AtkComponent, AtkRelation, AtkRelationSet, AtkStateSet, AtkSelection		Object that can be drawn into and used to trap events.
		INVALID			An error condition, such as an uninitialized role.
		UNKNOWN			Object contains accessible information but its role is not known.
	NOTE	add custom role
	IMAGE_MAP	add custom role
	FOOTNOTE	add custom role
	END_NOTE	add custom role

Document Author/Editor:	Catherine Laws IBM Software Group Accessibility Architecture and Development e-mail
	Most content derived from other documents and major contributions from: Bill Haneman (Sun) IBM Accessibility Architecture team (George Kraft, Pete Brunet, Larry Weiss, Aaron Leventhal, Richard Schwerdtfeger, Mark Pilgrim, Sueann Nichols, Donald B Clippingdale, Peter Parente) Authors of the documents in the /References section.

MSAA 1.3 State (STATE_SYSTEM_ *)	IAccessible2 States (IA2_State_*)	CLOSEST ATK State(s) (ATK_STATE_*)	Description
ANIMATED		ANIMATED (proposed) or add custom state	Object's visual representation is changing or moving rapidly; it 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.
BUSY		BUSY	Control cannot accept input at this time. Usually used on objects such as progress bars, sliders, or scroll bars to indicate they are in a state of transition.
CHECKED		CHECKED	Checkbox, radio button, or toggle button is checked.
COLLAPSED		!EXPANDED, COLLAPSED	Expandable objects that provide progressive disclosure, like a tree list or drop-down list is currently not expanded (i.e. the children are not showing or visible).
DEFAULT		DEFAULT_BUTTON (proposed) <Or add as a state or relation enumeration, or an attribute>	Default button or menu item.
EXPANDED		EXPANDED	The children items of expandable objects that provide progressive disclosure, like trees and drop-down lists are currently showing and visible.
EXTSELECTABLE		add custom state	Object can extend its selection.
FLOATING		add custom state	Object is not clipped to the boundary of the parent (i.e. it does not auto-move with the parent).
FOCUSABLE		FOCUSABLE	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.
FOCUSED		FOCUSED	Object currently has the keyboard focus.
HASPOPUP		Use ATK_RELATION_POPUP_FOR to point to the parent of the popup. Use ATK_ROLE_MENU to indicate a menu item has a submenu.	Object has a popup, but in ATK the popup children need to establish the relationship with the parent.
HOTTRACKED		don't use	Object's appearance has changed for a mouseover.
INVISIBLE		!VISIBLE	The object is hidden, whether on-screen or off-screen.
LINKED		Use ATK_ROLE_LINK	The object links to another object.
MARQUEED		ANIMATED (proposed)	The object is constantly changing and fleeting across the screen.
MIXED		INDETERMINATE or add custom state	A checkbox object is in a state other than checked or not checked, such as a tri-state checkbox might be.
MOVEABLE		add custom state	Object can be moved or dragged around the screen.
MULTISELECTABLE		MULTISELECTABLE	Object allows more than one of its children to be selected at the same time.
NORMAL			Object has no states.
OFFSCREEN		!SHOWING	An object is currently not visible and not on-screen. Partially on-screen
PRESSED		PRESSED	Object is currently pressed down.
PROTECTED		Use ATK_PASSWORD_TEXT as the role	Object is a password field.
READONLY		!EDITABLE & SENSITIVE	Object is interactive (sensitive) but the contents currently cannot be edited (changed) by the user.
SELECTABLE		SELECTABLE	Object is the child of an object that allows its children to be selected, and this child is one that can be selected.
SELECTED		SELECTED	Object is the child of an object that allows its children to be selected, and this child is selected.
SELFVOICING		add custom state	Object is self-voiced by the application, so an AT should not speak this object.
SIZEABLE		RESIZABLE	The size of the object can be changed (i.e. it is not fixed.)
TRAVERSED		Use a object attribute or add a custom state? VISITED (Proposed)	The link object was traversed (visited).
UNAVAILABLE		!ENABLED	Object is grayed out and not available at this time.
	ACTIVE	ACTIVE	A window is currently the active window, or is an active sub-element within a container or table. Includes windows, dialogs, frames, etc. In addition, this state is used to indicate the currently active child of a component such as a list, table, or tree. For example, the active child of a list is the child that is drawn with a rectangle around it. If ACTIVE state, then also MANAGES_DESCENDANTS.
	ARMED	ARMED	The object is armed. Usually used on buttons that have been pressed but not yet released, and the mouse pointer is still over the button.
	DEFUNCT	DEFUNCT	User interface object corresponding to this object no longer exists.
	EDITABLE	EDITABLE	The contents of this object can change.
		ENABLED	Object is not grayed out and can be interacted with if sensitive.
EXPANDED or COLLAPSED		EXPANDABLE	The children items of this object that provide progressive disclosure, like trees and drop-down lists, can be showing and visible (expanded) versus hidden (collapsed).
		HAS_TOOLTIP	Object has an associated tooltip. Tooltip text should be accessible description.
	HORIZONTAL	HORIZONTAL	Orientation of this object is horizontal.
	ICONIFIED	ICONIFIED	Object is minimized and represented only by an icon.
	INVALID	INVALID	Object is in an invalid state.
	INVALID_ENTRY	INVALID_ENTRY	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.
	MANAGES_DESCENDANTS	MANAGES_DESCENDANTS	Indicates that "active-descendant-changed" event is sent when children become 'active' (i.e. are selected or navigated to onscreen). Typically used for trees and tables that have a large number of subcomponents and where the objects are created only when needed and otherwise remain virtual. The application should not manage the subcomponents directly. If ACTIVE state, then also MANAGES_DESCENDANTS.
	MODAL	MODAL	Something must be done with this object before the user can interact with an object in a different window.
	MULTI_LINE	MULTI_LINE	Text object can contain multiple lines of text.
	OPAQUE	OPAQUE	Object paints every pixel within its rectangular region. A non-opaque component paints only some of its pixels, allowing the pixels underneath it to "show through". A component that does not fully paint its pixels therefore provides a degree of transparency.
	REQUIRED	REQUIRED	Explicit user interaction with this object is required by the user interface.
	SELECTABLE_TEXT	SELECTABLE_TEXT	Object 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 is a selectable child of an object which implements Selection. While similar, text selection and subelement selection are distinct operations.
		SENSITIVE	Object can be interactive, although it may currently be read-only or not enabled (grayed out). 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.
		SHOWING	Object is visible and on-screen.
	SINGLE_LINE	SINGLE_LINE	Text object can only contain a single line of text.
	STALE	STALE	Index associated with this object has changed since the user accessed the object. The information returned for this object may no longer be synchronized with the application state.
	SUPPORTS_AUTOCOMPLETION	SUPPORTS_AUTOCOMPLETION	Object 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.
	TRANSIENT	TRANSIENT	Object is changing or moving rapidly. An assistive technology should not add a property change listener to an object with transient state, as that object will never generate any events. Transient objects are typically created to answer ATK accessibility method queries, but otherwise do not remain linked to the underlying object (for example, those objects underneath lists, tables, and trees, where only one actual UI component does shared rendering duty for all of the data objects underneath the actual list/table/tree elements).
	?	TRUNCATED	Object is truncated, such as a numerical value in a spreadsheet cell.
	VERTICAL	VERTICAL	Orientation of this object is vertical.
		VISIBLE	Object is not hidden but may be off-screen. 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'.

MSAA 1.3 EVENT (EVENT_OBJECT_ *)	IAccessible2 Events (IA2_EVENT_*)	CLOSEST ATK Object Event(s) or Signals and the ATK Interface	Description
CREATE, DESTROY		Window events: create, close	An object has been created or destroyed. The system sends this event for the following user interface elements: caret, header, list view, tab, tree view, toolbar, and window objects.
SHOW			A hidden object is shown. The system sends this event for the following user interface elements: caret, cursor, and window object. Hidden objects do not set the ATK_STATE_VISIBLE flag; shown objects do set this flag. The SHOW event also indicates that the ATK_STATE_VISIBLE flag is set. ATK:The visible data of this object has changed. The character offset of the text caret (visible or notional) within this object has changed. Events of this type may also be generated when an onscreen text caret appears or disappears.
HIDE			An object is hidden. The system sends this event for the following user interface elements: caret and cursor. ATK: The character offset of the text caret (visible or notional) within this object has changed. Events of this type may also be generated when an onscreen text caret appears or disappears.
REORDER	children_changed_add children_changed_remove invalidate_all_children page_change	children-changed (AtkObject)	A container object has been added, removed, or reordered its children. The system sends this event for the following user interface elements: header control, list view control, toolbar control, and window object. For example, this event is generated by a list view object when the number of child elements or the order of the elements changes. This event is also sent by a parent window when the z order for the child windows changes. ATK: The number or identity of an object's children has changed.
FOCUS	See: ACTIVE_DESCENDANT_CHANGED	focus-event (AtkObject) See: active-descendant-changed (AtkObject)	An object has received the keyboard focus. The system sends this event for the following user interface elements: list view control, menu bar, pop-up menu, switch window, tab control, tree view control, and window object.
SELECTION		selection-changed (AtkSelection)	The selection within a container object has changed. The system sends this event for the following user interface elements: list view control, tab control, tree view control, and window object. ATK: An instance of Selection has undergone a change in the 'selected-ness' of its children, i.e. had a selection added, removed, and/or modified. Usually accompanied by corresponding `"object:state-changed:selected"` events from the corresponding children, unless the children are previously un-queried via AT-SPI and the Selection instance has STATE_MANAGES_DESCENDANTS.
	ACTIVE_DESCENDANT_CHANGED	active-descendant-changed (AtkObject)	If the object includes STATE_MANAGES_DESCENDANTS, this event is fired to indicate that the descendant having STATE_ACTIVE has changed; this corresponds to "micro" keyboard focus when the containing/emitting object has "macro" or technical keyboard focus. For instance, this event is usually emitted while traversing tables and/or spreadsheet cells.
SELECTIONADD, SELECTIONREMOVE, SELECTIONWITHIN		selection-changed (AtkSelection)	An item within a container object has been added to or removed from the selection. The system sends these events for the following user interface elements: list box, list view control, and tree view control. For SELECTIONWITHIN, numerous selection changes have occurred within a container object. The system sends this event for list boxes. Used instead of sending several SELECTIONADD or SELECTIONREMOVE events. ATK: An instance of Selection has undergone a change in the 'selected-ness' of its children, i.e. had a selection added, removed, and/or modified. Usually accompanied by corresponding `"object:state-changed:selected"` events from the corresponding children, unless the children are previously un-queried via AT-SPI and the Selection instance has STATE_MANAGES_DESCENDANTS.
STATECHANGE Also:[[BR]] EVENT_SYSTEM_MENUPOPUPSTART EVENT_SYSTEM_MENUPOPUPEND		state-changed * (AtkObject) AtkObject::atk_object_notify_state_change	An object's state has changed. The system sends this event for the following user interface elements: check box, combo box, header control, push button, radio button, scroll bar, toolbar control, tree view control, up-down control, and window object. For example, a state change occurs when a button object is pressed or released, or when an object is enabled or disabled. ATK: The object's StateSet has had a state added or removed. (Any states.)
LOCATIONCHANGE	TEXT_CARET_MOVED or just is a location change	bounds-changed (AtkComponent) text-bounds-changed (proposed - AtkText) text-caret-moved (AtkText)	An object has changed location, shape, or size. The system sends this event for the following user interface elements: caret and window object. Server applications send this event for their accessible objects. This event is generated in response to the top-level object within the object hierarchy that has changed, not for any children it might contain. For example, if the user resizes a window, the system sends this notification for the window, but not for the menu bar, title bar, scroll bars, or other objects that have also changed. The system does not send this event for every non-floating child window when the parent moves. However, if an application explicitly resizes child windows as a result of resizing, the system sends multiple events for the resized children. ATK: The 'bounds-changed" signal is emitted when the bposition or size of the a component changes. The character bounds of a text object have changed, for instance in response to a reformatting or reflow operation. The character offset of the text caret (visible or notional) within this object has changed. Events of this type may also be generated when an onscreen text caret appears or disappears.
NAMECHANGE		property-change::accessible-name (AtkObject)	An object's name property has changed. The system sends this event for the following user interface elements: check box, cursor, list view control, push button, radio button, status bar control, tree view control, and window object. ATK: A base (strongly-typed) object attribute has changed, for instance "object:property-change:accessible-name". Notifed property subtypes include accessible-name, accessible-description, and accessible-parent.
DESCRIPTIONCHANGE		property-change::accessible-description (AtkObject)	An object's description property has changed. ATK: A base (strongly-typed) object attribute has changed, for instance "object:property-change:accessible-name". Notifed property subtypes include accessible-name, accessible-description, and accessible-parent.
VALUECHANGE		value-changed (proposed - AtkObject?) property-change::accessible-value (AtkObject)	An object's value property has changed. The system sends this event for the following user interface elements: edit control, header control, hot key control, progress bar control, scroll bar, slider control, and up-down control. ATK: The value of this object has changed.
	TEXT_CHANGED	text-changed (AtkText)	The text content of this object has changed.
	HYPERTEXT_CHANGED
PARENTCHANGE		property-change::accessible-parent (AtkObject)	An object has a new parent object. ATK: A base (strongly-typed) object attribute has changed, for instance "object:property-change:accessible-name". Notifed property subtypes include accessible-name, accessible-description, and accessible-parent.
	TABLE_CAPTION_CHANGED TABLE_COLUMN_DESCRIPTION_CHANGED TABLE_COLUMN_HEADER_CHANGED TABLE_ROW_DESCRIPTION_CHANGED TABLE_ROW_HEADER_CHANGED TABLE_SUMMARY_CHANGED	Other property-change:: signals in AtkObject: accessible-component-layer accessible-component-mdi-zorder accessible-hypertext-nlinks accessible-role accessible-table-caption-object accessible-table-column-description accessible-table-column-header accessible-table-row-description accessible-table-row-header accessible-table-summary
		Other property-change:: signals in AtkHyperlink: end-index number-of-anchors selected-link start-index
HELPCHANGE			An object's help property has changed.
ACCELERATORCHANGE			An object's key bindings has changed.
DEFACTIONCHANGE	See: ACTION_CHANGED		An object's default action property has changed. The system sends this event for dialog boxes.
	ACTION_CHANGED		The change of the number or attributes of actions of an accessible object is signaled. There will be cases where the action that changed is not the default action.
		attribute-change (AtkObject - proposed)	A weakly-typed property has changed in value, been added, or been removed from the object. (attribute-change notifications were added in AT-SPI 1.7.0) Still need a way to register weakly-typed properties in AtkObject .
		load-complete (AtkDocument - proposed)	A pending (static) document content load has completed.
		reload (AtkDocument - proposed)	A reload of the document content has been initiated.
		load-stopped (AtkDocument - proposed)	Loading of the document content has been interrupted.
		content-changed (AtkDocument - proposed)	The contents of the Document container has changed.
		attributes-changed (AtkDocument - proposed)	The global attributes (i.e. document-wide attributes) of the Document have changed.
	TEXT_ATTRIBUTE_CHANGED	text-attributes-changed (AtkText)	The attributes of a range of text, or the range over which attributes apply, has changed.
	TEXT_SELECTION_CHANGED	text-selection-changed (AtkText)	The range or number of text selections within this text object has changed
		link-activated (AtkHyperlink)	The signal link-activated is emitted when a link is activated.
		link-selected (AtkHypertext)	The "link-selected" signal is emitted by an AtkHyperText object when one of the hyperlinks associated with the object is selected.
	object:row-deleted object:row-inserted object:row-reordered object:column-deleted object:column-inserted object:column-reordered	column-deleted (AtkTable)column-inserted (AtkTable)column-reordered (AtkTable)row-deleted (AtkTable)row-inserted (AtkTable)row-reordered (AtkTable)model-changed (AtkTable)	The "column-deleted" signal is emitted by an object which implements the AtkTable interface when a column is deleted. The "column-inserted" signal is emitted by an object which implements the AtkTable interface when a column is inserted.The "column-reordered" signal is emitted by an object which implements the AtkTable interface when columns are reordered. The "row-deleted" signal is emitted by an object which implements the AtkTable interface when a row is deleted. The "row-inserted" signal is emitted by an object which implements the AtkTable interface when a row is inserted.The "row-reordered" signal is emitted by an object which implements the AtkTable interface when rows are reordered. The "model-changed" signal is emitted by an object which implements the AtkTable interface when the model displayed by the table changes.
EVENT_SYSTEM_MINIMIZESTART, :: EVENT_SYSTEM_MINIMIZEEND, EVENT_SYSTEM_MOVESIZESTART, :: EVENT_SYSTEM_MOVESIZEEND, EVENT_SYSTEM_FOREGROUND ::		window events: minimize, maximize, restore, activate, deactivate, move, size

IAccessible2 Relations (IA2_Relation_*)	CLOSEST ATK Relation(s) (ATK_RELATION_*)	Description
CONTROLLED_BY	CONTROLLED_BY	Object state, position, etc. is modified/controlled by user interaction with one or more other objects. For instance a viewport or scroll pane may be CONTROLLED_BY scrollbars.
CONTROLLER_FOR	CONTROLLER_FOR	Object is an interactive object which modifies the state, onscreen location, or other attributes of one or more target objects.
	DESCRIBED_BY	Indicates that another object provides descriptive information about this object; more verbose than ATK_RELATION_LABELLED_BY.
	DESCRIPTION_FOR	Indicates that an object provides descriptive information about another object; more verbose than ATK_RELATION_LABEL_FOR.
EMBEDDED_BY	EMBEDDED_BY	Reciprocal of RELATION_EMBEDS; Used to denote content rendered by embedded renderers that live in a separate process space from the embedding context.
EMBEDS	EMBEDS	Similar to SUBWINDOW_OF, but specifically used for cross-process embedding.
FLOWS_FROM	FLOWS_FROM	Reciprocal of RELATION_FLOWS_TO.
FLOWS_TO	FLOWS_TO	Object renders content which flows logically to another object. For instance, text in a paragraph may flow to another object which is not the �next sibling� in the accessibility hierarchy.
LABEL_FOR	LABEL_FOR	Object is a label for one or more other objects.
LABELED_BY	LABELLED_BY	Object is labelled by one or more other objects.
MEMBER_OF	MEMBER_OF	Object has a grouping relationship (e.g. �same group as�) to one or more other objects.
NODE_CHILD_OF	NODE_CHILD_OF	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.
PARENT_WINDOW_OF	PARENT_WINDOW_OF	Indicates that an object is a parent window of another object.
POPUP_FOR	POPUP_FOR	Denotes that the object is a transient window or frame associated with another onscreen object. Similar to TOOLTIP_FOR, but more general. Useful for windows which are technically toplevels but which, for one or more reasons, do not explicitly cause their associated window to lose �window focus�. Creation of a ROLE_WINDOW object with the POPUP_FOR relation usually requires some presentation action on the part of assistive technology clients, even though the previous toplevel ROLE_FRAME object may still be the active window.
	RELATION_EXTENDED (AT-SPI only?)	Used to indicate that a relationship exists, but its type is not specified in the enumeration and must be obtained via a call to getRelationName.
SUBWINDOW_OF	SUBWINDOW_OF	Object is visually and semantically considered a subwindow of another object, even though it is not the object's child. Useful when dealing with embedded applications and other cases where the widget hierarchy does not map cleanly to the onscreen presentation.
	TOOLTIP_FOR (proposed)	Object is a tooltip associated with another object.

MSAA Server Interfaces and Functions	ATK (and AT-SPI) object interfaces	Description
'''CreateStdAccessibleObject'''	AtkObject* atk_object_factory_create_accessible (AtkObjectFactory factory, GObject obj); void atk_object_initialize (AtkObject *accessible, gpointer data);	MSAA: Creates an accessible object with the methods and properties for the specified type of system-provided user interface element. ATK: Provides an AtkObject that implements an accessibility interface on behalf of `obj`. atk_object_initialize is called when implementing subclasses of AtkObject.
'''CreateStdAccessibleProxy'''		MSAA: creates an accessible object that has the properties and methods of the specified class of system-provided user interface element.
'''LresultFromObject'''	AtkObject:: atk_implementor_ref_accessible	MSAA: returns a reference, that is similar to a handle, to the specified object. Servers return this reference when handling WM_GETOBJECT. ATK: Gets a reference to an object's AtkObject implementation, if the object implements AtkObjectIface
'''NotifyWinEvent'''	Accessibility::notifyEvent (in Event e) (AtkEventListener) (AtkObject); See also:atk_add_global_event_listener (*AtkEventListenerInit) atk_remove_global_event_listener	MSAA: signals the system that a predefined event occurred. If any client applications have registered a hook function for the event, the system calls the client's hook function.
'''IAccessibleHandler::AccessibleObjectFromID'''		MSAA: retrieves an IAccessible interface pointer for the interface associated with the given object ID. Oleacc.dll uses this method to obtain an IAccessible interface pointer for proxies that are supplied by other code.
GetTypeInfoCount		MSAA: returns the number of type descriptions for the object. For objects that support IDispatch, the type information count is always one.
GetTypeInfo	GType atk_object_factory_get_accessible_type (AtkObjectFactory *factory);	MSAA: retrieves a description of the object's programmable interface. ATK: Gets the GType of the accessible which is created by the factory.
GetIDsOfNames		MSAA: maps the name of a method or property to a DISPID, which is later used to invoke the method or property.
Invoke		MSAA: calls one of the object's methods, or gets or sets one of its properties.

MSAA IAccessible methods	ATK interface	Description
Navigation and Hierarchy	From AtkObject
accNavigate ( long, VARIANT, VARIANT* );		MSAA: traverses to another user interface (UI) element within a container and retrieves the object. All visual objects must support this method. Note: Firefox extended this interface to to navigate to relations by adding new constants. IARelation is already being used so we will keep it. ATK: No equivalent, except the future addition to AT-SPI of the Collection interface.
get_accChild ( VARIANT, IDispatch** );	AtkObject* atk_object_ref_accessible_child (AtkObject *accessible, gint i);	MSAA: retrieves an '''IDispatch''' interface pointer for the specified child, if one exists. All objects must support this property. ATK: Gets a reference to the specified accessible child of the object. The accessible children are 0-based so the first accessible child is at index 0, the second at index 1 and so on.
get_accChildCount ( long* );	gint atk_object_get_n_accessible_children (AtkObject *accessible);	MSAA: retrieves the number of children that belong to this object. All objects must support this property. ATK: Gets the number of accessible children of the accessible.
get_accParent ( IDispatch** );	AtkObject* atk_object_get_parent (AtkObject *accessible);	MSAA: retrieves the '''IDispatch''' interface of the object's parent. All objects support this property.
===== Descriptive Properties and Methods =====	From AtkAction, AtkObject, AtkValue
accDoDefaultAction ( VARIANT );	gboolean atk_action_do_action (AtkAction *action, gint i);	MSAA: performs the specified object's default action. Not all objects have a default action. Similar to IAccessibleAction::doAction, but it provides for more than one action. The first IAAction should be the default action.
get_accDefaultAction ( VARIANT, BSTR* );	const gchar* atk_action_get_name (AtkAction *action, gint i); See also: atk_action_get_localized_name	MSAA: retrieves a string that describes the object's default action. Not all objects have a default action. IAccessibleAction has getters for description and the key binding. Both are strings. ATK: Returns the name of the specified action of an object. If there are more than one action for an object, the first one is considered the "default" action.
get_accDescription ( VARIANT, BSTR* );	const gchar* atk_object_get_description (AtkObject *accessible);	MSAA: retrieves a string that describes the visual appearance of the specified object. Not all objects have a description.
get_accHelp ( VARIANT, BSTR* );		MSAA: retrieves an object's Help property string. Not all objects support this property. ATK: No equivalent.
get_accHelpTopic ( BSTR, VARIANT, long );		MSAA: retrieves the full path of the WinHelp file associated with the specified object and the identifier of the appropriate topic within that file. Not all objects support this property. ATK: No equivalent.
get_accKeyboardShortcut ( VARIANT, BSTR* );	const gchar* atk_action_get_keybinding (AtkAction *action, gint i);	MSAA: retrieves the specified object's shortcut key or access key, also known as the mnemonic. All objects that have a shortcut key or an access key support this property. Similar to IAccessibleAction::keyBinding. MSAA shortcuts can be on controls with no default action such as a text box or static text next to a text box (label). IAccessible2 key bindings are only on actionable controls. They are needed for image maps or a control that has more than one action. If there is only one action on an actionable control, there is no need to implement IAccessibleAction. ATK: Get keybinding associated with action for object.
get_accName ( VARIANT, BSTR* );	const gchar* atk_object_get_name (AtkObject *accessible);	MSAA: retrieves the name of the specified object. All objects support this property.
get_accRole ( VARIANT, VARIANT* );	AtkRole atk_object_get_role (AtkObject *accessible); See also: atk_role_get_name,atk_role_get_localized_name, [[BR]]atk_role_for_name http://developer.gnome.org/doc/API/2.0/atk/AtkObject.html#atk-role-get-localized-name	MSAA: retrieves information that describes the role of the specified object. All objects support this property. MSAA roles run from 1 - 0x40, new IAccessible2 roles will be mapped at higher values, starting at 0x100. There will be IAccessible2:roleName and IAccessible2::localizedRoleName.
get_accState ( VARIANT, VARIANT* );	AtkStateSet* atk_object_ref_state_set (AtkObject *accessible);	MSAA: retrieves the current state of the specified object. All objects support this property.Use MSAA get_accStates for states that map to MSAA states. For new states: IAccessible::states returns additional IAccessible2 states in a 32 bit bitstrip. The AT will sense for the presence of IAccessible2 and if found fetch the states. ATK: Gets a reference to the state set of the accessible
get_accValue ( VARIANT, BSTR* );	void atk_value_get_current_value (AtkValue obj, GValue value);	MSAA: retrieves the value of the specified object. Not all objects have a value. IAccessibleValue::currentValue is not a duplicate. MSAA returns a string. IAccessible2 returns an integer. get_accValue is needed when something like "blue" is a meaningful return value. IAccessibleValue is needed when min/max/current integers are meaningful. MSAA has no min/max capability. IAccessible2 has no string capability. They are both needed.
Selection and Focus	From AtkSelection and AtkComponent
accSelect ( long, VARIANT );	gboolean atk_selection_add_selection (AtkSelection selection, gint i); AND gboolean atk_component_grab_focus (AtkComponent component);	MSAA: modifies the selection or moves the keyboard focus of the specified object. All objects that support selection or receive the keyboard focus must support this method. It does take focus, take/extend selection/add/remove. Duplicate of or similar to IAccessibleSelection::selectAccessibleChild. Get note from Aaron. ATK: Adds the specified accessible child of the object to the object's selection. Plus Grabs focus for this `component`.
get_accFocus ( VARIANT* );	Walk the tree and check for object that has focus	MSAA: retrieves the object that has the keyboard focus. All objects that receive the keyboard focus must support this property. ATK:
get_accSelection ( VARIANT * );	See: atk_selection_ref_selection, atk_selection_get_selection_count	MSAA: retrieves the selected children of this object. All objects that support selection must support this property.
===== Spatial Mapping =====	From AtkComponent
accLocation ( long, long, long* long*, VARIANT);	void atk_component_get_position (AtkComponent component, gint x, gint y, AtkCoordType coord_type); atk_component_get_extents (AtkComponent component, gint x, gint y, gint width, gint height, AtkCoordType coord_type); See also: atk_component_set_position	MSAA: retrieves the specified object's current screen location. All visual objects must support this method; sound objects do not support it. ATK: Gets the position of `component` in the form of a point specifying `component`s top-left corner. Gets the rectangle which gives the extent of the `component`.
accHitTest ( long, long, '''VARIANT'''* );	AtkObject* atk_component_ref_accessible_at_point (AtkComponent *component, gint x, gint y, AtkCoordType coord_type);	MSAA: retrieves the child element or child object at a given point on the screen. All visual objects support this method; sound objects do not support it. Similar to IAccessibleComponent:accessibleAtPoint.BR ATK: Gets a reference to the accessible child, if one exists, at the coordinate point specified by `x` and `y`.
Put functions	From AtkObject and AtkValue
put_accName	void atk_object_set_name (AtkObject accessible, const gchar name);	MSAA: is no longer supported. Client applications should use a control-specific workaround, such as the SetWindowText API. Servers should return E_NOTIMPL. ATK: Sets the accessible name of the accessible.
	void atk_object_set_description (AtkObject accessible, const gchar description);	MSAA: No equivalent. ATK: Sets the accessible description of the accessible.
	void atk_object_set_parent (AtkObject accessible, AtkObject parent);	MSAA: No equivalent. ATK: Sets the accessible parent of the accessible.
	void atk_object_set_role (AtkObject *accessible, AtkRole role);	MSAA: No equivalent. ATK: Sets the role of the accessible.
put_accValue	gboolean atk_value_set_current_value (AtkValue obj, const GValue value);	MSAA: is supported for some user interface (UI) elements (usually edit controls). For UI elements that do not support this method, control-specific APIs are used instead. For more information, see Supported User Interface Element Reference. Duplicate of IAccessibleValue::setCurrentValue, or is the Value interface only integer? Probably not used.

GNOME Accessibility Team

Guidelines for Writing Accessible GNOME Applications Using GTK+ and the Accessibility Toolkit (ATK)

Abstract

Notices

Introduction

Disability Needs

Why use GTK+ and the ATK for Accessibility?

Essential Accessibility Programming Practices

GTK+ and ATK - A Foundation for GNOME Accessibility

Why use GTK+ widgets?

Creating accessible custom widgets

Setting up the accessible application development and test environment

Fedora extras and gnome-common

libgail-gnome

accerciser

Orca screen reader

Glade GUI builder (optional)

Using GTK+ and ATK to Build Accessible Applications

Using the GTK+ Widgets Unmodified

Exposing Accessible Information for Objects Embedded in GTK+ Text Widgets

!AttributeSets

Changing Data Models and Cell Renderers

ATK Implementations for GTK+ 2.0 Widgets

The Accessible Toolkit (ATK) API Reference

Building Custom Accessible Widgets

Start with a GTK widget class

Create and register an ''AtkObject'' factory

Creating an ATK object implementation class

Implement get_type plus class and instance initializer functions

Implement base ''AtkObject'' methods and properties

Implementing ATK Subinterfaces

Managing Children

Managing Events

ATK implementation examples for documents

Example: Paragraph with an Image in it

HTML source

Recommended ATK implementation

Example: Header with a break in it

HTML source

Recommended ATK implementation

Example: Link with a break in it

HTML source

Recommended ATK implementation

Example: Two paragraphs with a horizontal line

HTML source

Recommended ATK implementation

Example: Pagragraph with an emphasis

HTML source

Recommended ATK implementation

Example: Paragraph with a link in it

HTML source

Recommended ATK implementation

Link with an image in it

HTML source

Recommended ATK implementation

Example: BLAH with a break in it

HTML source

Recommended ATK implementation

Example: image map

HTML source

Recommended ATK implementation

Example: bulleted list

HTML source

Recommended ATK implementation

Example: numbered list

HTML source

Recommended ATK implementation

Example: nested bulleted lists

HTML source

Recommended ATK implementation

Example: form with a text area

HTML source

Recommended ATK implementation

Example: form with checkbox

HTML source

Recommended ATK implementation

Example: form with a selection

HTML source

Recommended ATK implementation

Example: form with a multi line selection