summaryrefslogtreecommitdiff
path: root/docs/tmpl/atkcomponent.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/tmpl/atkcomponent.sgml')
-rw-r--r--docs/tmpl/atkcomponent.sgml16
1 files changed, 13 insertions, 3 deletions
diff --git a/docs/tmpl/atkcomponent.sgml b/docs/tmpl/atkcomponent.sgml
index 046d8d4..fdef339 100644
--- a/docs/tmpl/atkcomponent.sgml
+++ b/docs/tmpl/atkcomponent.sgml
@@ -2,11 +2,21 @@
AtkComponent
<!-- ##### SECTION Short_Description ##### -->
-
-
+ATK Interface provided by UI components which occupy a physical area on
+the screen.
<!-- ##### SECTION Long_Description ##### -->
<para>
-
+#AtkComponent should be implemented by most if not all UI elements with
+an actual on-screen presence, i.e. components which can be said to have
+a screen-coordinate bounding box. Virtually all widgets will need to
+have #AtkComponent implementations provided for their corresponding
+#AtkObject class. In short, only UI elements which are *not* GUI
+elements will omit this ATK interface.
+</para>
+<para>
+A possible exception might be textual information with a transparent
+background, in which case text glyph bounding box information is
+provided by #AtkText.
</para>
<!-- ##### SECTION See_Also ##### -->