Adding descriptions for atspi-component.
authorAline Bessa <alibezz@gmail.com>
Mon, 1 Aug 2011 22:49:44 +0000 (19:49 -0300)
committerMike Gorse <mgorse@novell.com>
Wed, 24 Aug 2011 03:12:01 +0000 (22:12 -0500)
doc/libatspi/tmpl/atspi-component.sgml

index 39e0915..546137e 100644 (file)
@@ -2,11 +2,19 @@
 atspi-component
 
 <!-- ##### SECTION Short_Description ##### -->
-
+ An interface implemented by objects which have onscreen visual 
+ representations.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+  The Component interface is implemented by objects which occupy on-screen
+  space, e.g. objects which have onscreen visual representations. The methods
+  in Component allow clients to identify where the objects lie in the onscreen
+  coordinate system, their relative size, stacking order, and position. It
+  also provides a mechanism whereby keyboard focus may be transferred to 
+  specific user interface elements programmatically.  This is a 2D API. 
+  Coordinates of 3D objects are projected into the 2-dimensional screen view
+  for purposes of this interface.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->