summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJohan Dahlin <johan@gnome.org>2008-01-25 16:17:38 +0000
committerJohan Dahlin <johan@src.gnome.org>2008-01-25 16:17:38 +0000
commitfddc9b8561afe82cfb39133f705712e2c9a79e6e (patch)
treedf1ee05137f86b1256c586a934e7a750331173b8 /docs
parent7b8050aff20b6b151a0b0e540387112a05fb8d48 (diff)
downloadgtk+-fddc9b8561afe82cfb39133f705712e2c9a79e6e.tar.gz
Implement accessible support, fixes #454653.
2008-01-25 Johan Dahlin <johan@gnome.org> * gtk/gtkwidget.c: (gtk_widget_buildable_interface_init), (gtk_widget_buildable_get_internal_child), (free_action), (free_relation), (gtk_widget_buildable_parser_finished), (accessibility_start_element), (gtk_widget_buildable_custom_tag_start), (gtk_widget_buildable_custom_finished): Implement accessible support, fixes #454653. * gtk/gtk-builder-convert: Add support for migrating old glade files * tests/buildertest.c: (test_widget), (test_file): Add accessible tests and improve the test_file function to display toplevels and run dialogs. svn path=/trunk/; revision=19403
Diffstat (limited to 'docs')
-rw-r--r--docs/reference/ChangeLog5
-rw-r--r--docs/reference/gtk/tmpl/gtkwidget.sgml25
2 files changed, 30 insertions, 0 deletions
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index f84a3e6d81..b30db862a9 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2008-01-24 Johan Dahlin <johan@gnome.org>
+
+ * gtk/tmpl/gtkwidget.sgml:
+ Add documentation for <accessible> buildable tag.
+
2008-01-14 Matthias Clasen <mclasen@redhat.com>
* gtk/gtk-docs.sgml:
diff --git a/docs/reference/gtk/tmpl/gtkwidget.sgml b/docs/reference/gtk/tmpl/gtkwidget.sgml
index 11f7d4ccfc..b03ee0b9f5 100644
--- a/docs/reference/gtk/tmpl/gtkwidget.sgml
+++ b/docs/reference/gtk/tmpl/gtkwidget.sgml
@@ -37,6 +37,31 @@ modifiers and signal and allows to specify accelerators.
</object>
]]></programlisting>
</example>
+In addition to accelerators, <structname>GtkWidget</structname> also support a
+custom &lt;accessible&gt; element, which supports actions and relations.
+Properties on the accessible implementation of an object can be set by accessing the
+internal child "accessible" of a <structname>GtkWidget</structname>.
+<example>
+<title>A UI definition fragment specifying an accessible</title>
+<programlisting><![CDATA[
+<object class="GtkButton" id="label1"/>
+ <property name="label">I am a Label for a Button</property>
+</object>
+<object class="GtkButton" id="button1">
+ <accessibility>
+ <action action_name="click" description="Click the button."/>
+ <relation target="label1" type="labelled-by"/>
+ </accessibility>
+ <child internal-child="accessible">
+ <object class="AtkObject" id="a11y-button1">
+ <property name="AtkObject::name">Clickable Button</property>
+ </object>
+ </child>
+</object>
+]]></programlisting>
+</example>
+
+
</refsect2>
<!-- ##### SECTION See_Also ##### -->