summaryrefslogtreecommitdiff
path: root/docs/reference/cspi/tmpl
diff options
context:
space:
mode:
Diffstat (limited to 'docs/reference/cspi/tmpl')
-rw-r--r--docs/reference/cspi/tmpl/spi_accessible.sgml12
-rw-r--r--docs/reference/cspi/tmpl/spi_action.sgml12
-rw-r--r--docs/reference/cspi/tmpl/spi_application.sgml8
-rw-r--r--docs/reference/cspi/tmpl/spi_component.sgml7
-rw-r--r--docs/reference/cspi/tmpl/spi_editabletext.sgml6
-rw-r--r--docs/reference/cspi/tmpl/spi_value.sgml11
6 files changed, 44 insertions, 12 deletions
diff --git a/docs/reference/cspi/tmpl/spi_accessible.sgml b/docs/reference/cspi/tmpl/spi_accessible.sgml
index 4fdfaf6..5b3f137 100644
--- a/docs/reference/cspi/tmpl/spi_accessible.sgml
+++ b/docs/reference/cspi/tmpl/spi_accessible.sgml
@@ -2,11 +2,19 @@
Accessible Objects
<!-- ##### SECTION Short_Description ##### -->
-
+The base accessibility interface which all accessible objects implement.
<!-- ##### SECTION Long_Description ##### -->
<para>
-
+The Accessible interface provides for a hierarchical tree of accessible
+objects corresponding to user interface components and content in an
+accessible application. Accessible objects provide name, descriptive
+information, state information, and information on the "role" of the object in
+the user interface. The capabilities of these objects may be queried via
+interface queries, as they are implemented via interface aggregation. These
+objects are located in a containment hierarchy with parent/child
+relationships, and may have other functional relationships to objects within
+the tree.
</para>
<!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/cspi/tmpl/spi_action.sgml b/docs/reference/cspi/tmpl/spi_action.sgml
index 28ee6d4..a212ee8 100644
--- a/docs/reference/cspi/tmpl/spi_action.sgml
+++ b/docs/reference/cspi/tmpl/spi_action.sgml
@@ -2,11 +2,19 @@
AccessibleAction Interface
<!-- ##### SECTION Short_Description ##### -->
-
+The interface implemented by interface elements which are 'actionable' by the
+user.
<!-- ##### SECTION Long_Description ##### -->
<para>
-
+The Action interface is implemented by objects with which the user may
+interact using common graphical-user-interface metaphors such as "click",
+"toggle", "activate", and other gestures which are usually invoked via
+interaction with the system pointer or keyboard. The Action interface allows
+clients and/or assistive technologies to expose these actions to the end user
+for invocation via alternative mechanisms, and to inform the end user or
+assistive technology client that the implementing Accessible object is
+reactive to user input.
</para>
<!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/cspi/tmpl/spi_application.sgml b/docs/reference/cspi/tmpl/spi_application.sgml
index 8e00617..3c74bd8 100644
--- a/docs/reference/cspi/tmpl/spi_application.sgml
+++ b/docs/reference/cspi/tmpl/spi_application.sgml
@@ -2,11 +2,15 @@
AccessibleApplication API
<!-- ##### SECTION Short_Description ##### -->
-
+The interface implemented by the topmost Accessible in an application's
+hierarchy of Accessible objects.
<!-- ##### SECTION Long_Description ##### -->
<para>
-
+This interface is implemented on the topmost object in an application's
+hierarchy. It is primarily a marker interface, though certain properties
+associated with an application, such as the application's current default
+locale, are also exposed.
</para>
<!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/cspi/tmpl/spi_component.sgml b/docs/reference/cspi/tmpl/spi_component.sgml
index 2cf0f89..27aa486 100644
--- a/docs/reference/cspi/tmpl/spi_component.sgml
+++ b/docs/reference/cspi/tmpl/spi_component.sgml
@@ -2,11 +2,14 @@
AccessibleComponent Interface
<!-- ##### SECTION Short_Description ##### -->
-
+An interface implemented by objects which occupy area on screen.
<!-- ##### SECTION Long_Description ##### -->
<para>
-
+The Component interface is implemented by objects which are visible, or are
+potentially visible, onscreen. The interface exposes onscreen bounds, the
+approximate "layer" in which the object resides, sometimes including z-order
+information, and allows objects to explicitly be told to request focus.
</para>
<!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/cspi/tmpl/spi_editabletext.sgml b/docs/reference/cspi/tmpl/spi_editabletext.sgml
index 8b7703e..5083a28 100644
--- a/docs/reference/cspi/tmpl/spi_editabletext.sgml
+++ b/docs/reference/cspi/tmpl/spi_editabletext.sgml
@@ -2,11 +2,13 @@
AccessibleEditableText Interface
<!-- ##### SECTION Short_Description ##### -->
-
+An interface which allows editable text fields to be programmatically manipulated.
<!-- ##### SECTION Long_Description ##### -->
<para>
-
+An interface implemented by objects whose text content may be (potentially or
+actually) directly modified by user activity. Text entry fields and text
+editor compose panes are examples of EditableText implementors.
</para>
<!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/cspi/tmpl/spi_value.sgml b/docs/reference/cspi/tmpl/spi_value.sgml
index e7c970a..6be0fb6 100644
--- a/docs/reference/cspi/tmpl/spi_value.sgml
+++ b/docs/reference/cspi/tmpl/spi_value.sgml
@@ -2,11 +2,18 @@
AccessibleValue Interface
<!-- ##### SECTION Short_Description ##### -->
-
+An interface implemented by valuators, sliders, and other onscren components
+which allow discrete or continuous values to be manipulated.
<!-- ##### SECTION Long_Description ##### -->
<para>
-
+The Value interface is exposed by sliders, scrollbars, dials, and other
+components which are used to change scalar values in an application. The
+interface may be used to change a value in an "approximately continuous"
+fashion, or in integer increments - the interface allows the client to
+determine the incremental granularity of the adjustments possible, the
+possible range of values, and the current value. It also allows the value to
+be programmatically set, if the implementor's state does not include READONLY.
</para>
<!-- ##### SECTION See_Also ##### -->