aboutsummaryrefslogtreecommitdiff
path: root/libXaw/specs/CH3.xml
blob: 8fdefcc7b9c1dae24112bd7d265f195c658da097 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
<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>