dogtail-devel [Bug 356003] New: Here is a quick howto on adding accessibility to an app to be tested using dogtail.

["dogtail (bugzilla.gnome.org)" <bugzilla-daemon bugzilla gnome org>]

Do not reply to this via email (we are currently unable to handle email
responses and they get discarded).  You can add comments to this bug at
http://bugzilla.gnome.org/show_bug.cgi?id=356003
 dogtail | Examples | Ver: unspecified

           Summary: Here is a quick howto on adding accessibility to an app
                    to be tested using dogtail.
           Product: dogtail
           Version: unspecified
          Platform: Other
        OS/Version: All
            Status: UNCONFIRMED
          Keywords: documentation
          Severity: minor
          Priority: Normal
         Component: Examples
        AssignedTo: dogtail-maint gnome bugs
        ReportedBy: npremji redhat com
         QAContact: dogtail-maint gnome bugs
     GNOME version: Unspecified
   GNOME milestone: Unspecified


Documentation 
Section: Not in documentation (yet).
Nothing.

Correct version:
Here is how to set up standard widgets so that they can be seen by dogtail.

All Gtk widgets have associated accessibility objects. What dogtail needs is
for these widgets to be given names so they can be more easily accessed.

In order to do this in Gtk C code do the following (assuming the widget you are
looking at is called myWidget:

GtkWidget * widget = myWidget;
AtkObject *myAccessibility = gtk_widget_get_accessibility(widget);
atk_object_set_name(myAccessibility, _("My Name"));
atk_object_set_description(myAccessibility, _("My Description."));

_("") is for internationalization purposes if you so choose.

This is all dogtail needs to be able to access this widget by name.

In terms of java-gnome, the easiest thing to do is to open up the glade file
and click on the accessibility tab (far right) and give a name and description.

In java-gnome, if you can't use the glade accessibility, the code is very
similar:

AtkObject obj = widget.getAccessible();
obj.setName("My Name");
obj.setDescription("My Description");

This should give you accessibility for all standard widgets.

Other information:
Currently this text is hosted on: 

http://sourceware.org/frysk/developers/

but it seems as though this information would be usefull to anyone who wants to
be testing using dogtail. If you host this, then we can link to that page in
our faq.

Thank you.


-- 
Configure bugmail: http://bugzilla.gnome.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are watching the QA contact for the bug.
You are watching the assignee for the bug.