xenocara/lib/libXaw/specs/CH3.xml

124 lines
4.0 KiB
XML

<chapter id="simple_widgets">
<title>Simple Widgets</title>
<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH3.intro.xml"/> -->
<para>
Each of these widgets performs a specific user interface function. They
are <emphasis remap='I'>simple</emphasis> because they cannot have widget children\(emthey may only
be used as leaves of the widget tree. These widgets display information or
take user input.
</para>
<variablelist>
<varlistentry>
<term><function>Command</function></term>
<listitem>
<para>
A push button that, when selected, may cause a specific action
to take place. This widget can display a multi-line string or a bitmap or pixmap image.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><function>Grip</function></term>
<listitem>
<para>
A rectangle that, when selected, will cause an action to take place.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><function>Label</function></term>
<listitem>
<para>
A rectangle that can display a multi-line string or a bitmap or pixmap image.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><function>List</function></term>
<listitem>
<para>
A list of text strings presented in row column format that may be
individually selected. When an element is selected an action may take
place.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><function>Panner</function></term>
<listitem>
<para>
A rectangular area containing a <emphasis remap='I'>slider</emphasis> that may be moved in two
dimensions. Notification of movement may be continuous or discrete.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><function>Repeater</function></term>
<listitem>
<para>
A push button that triggers an action at an increasing rate when selected.
This widget can display a multi-line string or a bitmap or pixmap image.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><function>Scrollbar</function></term>
<listitem>
<para>
A rectangular area containing a <emphasis remap='I'>thumb</emphasis> that when slid along one
dimension may cause a specific action to take place. The Scrollbar may
be oriented horizontally or vertically.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><function>Simple</function></term>
<listitem>
<para>
The base class for most of the simple widgets. Provides a rectangular
area with a settable mouse cursor and special border.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><function>StripChart</function></term>
<listitem>
<para>
A real time data graph that will automatically update and scroll.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><function>Toggle</function></term>
<listitem>
<para>
A push button that contains state information. Toggles
may also be used as "radio buttons" to implement a "one of many" or
"zero or one of many" group
of buttons. This widget can display a multi-line string or a bitmap or pixmap image.
</para>
</listitem>
</varlistentry>
</variablelist>
<!-- End of CH3.Intr -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Command.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Grip.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Label.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="List.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Panner.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Repeater.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Scrollbar.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Simple.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="StripChart.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Toggle.xml"/>
</chapter>