aboutsummaryrefslogtreecommitdiff
path: root/libXaw/specs/SmeLine.xml
blob: 96c920b70212c817ca6b60736b553ae48e48437c (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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
<sect1 id="SmeLine_Object">
<title>SmeLine Object</title>
<para>
<!-- .LP -->
<!-- .XS -->
<!-- 	SmeLine Object -->
<!-- .XE -->
<!-- .IN "SmeLine object" "" "@DEF@" -->
<!-- .sp -->
<literallayout class="monospaced">
<!-- .TA 2.0i -->
<!-- .ta 2.0i -->
Application Header file	&lt;X11/Xaw/SmeLine.h&gt;
<!-- .IN "SmeLine.h" "" -->
Class Header file	&lt;X11/Xaw/SmeLineP.h&gt;
<!-- .IN "SmeLineP.h" "" -->
Class		smeLineObjectClass
<!-- .IN "smeLineObjectClass" "" -->
Class Name	SmeLine
<!-- .IN "SmeLine object" "class name" -->
Superclass	Sme
</literallayout>
<!-- .sp -->
</para>
<para>
<!-- .LP -->
The SmeLine object is used to add a horizontal line or menu separator to
a menu.  Since each SmeLine is an independent object, the application
is able to change the color, height, and other attributes of the SmeLine
objects on an entry by entry basis.  This object is not selectable, and
will not highlight when the pointer cursor is over it.
</para>
<sect2 id='SmeLine::Resources'>
<title>Resources</title>
<!-- .IN "SmeLine object" "resources" -->
<para>
<!-- .LP -->
The resources associated with the SmeLine object are defined in this section,
and affect only the single menu entry specified by this object.
<informaltable>
  <tgroup cols='5' align='center'>
  <colspec colname='c1'/>
  <colspec colname='c2'/>
  <colspec colname='c3'/>
  <colspec colname='c4'/>
  <colspec colname='c5'/>
  <thead>
    <row>
      <entry>Name</entry>
      <entry>Class</entry>
      <entry>Type</entry>
      <entry>Notes</entry>
      <entry>Default Value</entry>
    </row>
  </thead>
  <tbody>
    <row>
      <entry>destroyCallback</entry>
      <entry>Callback</entry>
      <entry>XtCallbackList</entry>
      <entry></entry>
      <entry>NULL</entry>
    </row>
    <row>
      <entry>foreground</entry>
      <entry>Foreground</entry>
      <entry>Pixel</entry>
      <entry></entry>
      <entry>XtDefaultForeground</entry>
    </row>
    <row>
      <entry>height</entry>
      <entry>Height</entry>
      <entry>Dimension</entry>
      <entry></entry>
      <entry><function>lineWidth</function></entry>
    </row>
    <row>
      <entry>international</entry>
      <entry>International</entry>
      <entry>Boolean</entry>
      <entry>C</entry>
      <entry>False</entry>
    </row>
    <row>
      <entry>lineWidth</entry>
      <entry>LineWidth</entry>
      <entry>Dimension</entry>
      <entry></entry>
      <entry>1</entry>
    </row>
    <row>
      <entry>stipple</entry>
      <entry>Stipple</entry>
      <entry>Pixmap</entry>
      <entry></entry>
      <entry>XtUnspecifiedPixmap</entry>
    </row>
    <row>
      <entry>width</entry>
      <entry>Width</entry>
      <entry>Dimension</entry>
      <entry></entry>
      <entry>1</entry>
    </row>
  </tbody>
  </tgroup>
</informaltable>
<!-- .Dc -->
<variablelist>
  <varlistentry>
    <term>foreground</term>
    <listitem>
      <para>
A pixel value which indexes the SimpleMenu's colormap to derive the
foreground color used to draw the separator line.
<!-- .Hw -->
Keep in mind that the SimpleMenu widget will force all menu items to
be the width of the widest entry.  Thus, setting the width is generally not
very important.
<!-- .Ix -->
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term>lineWidth</term>
    <listitem>
      <para>
The width of the horizontal line that is to be displayed.
      </para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term>stipple</term>
    <listitem>
      <para>
If a bitmap is specified for this resource, the line will be stippled
through it.  This allows the menu separator to be rendered as something
more exciting than just a line.  For instance, if you define a stipple
that is a chain link, then your menu separators will look like chains.
      </para>
    </listitem>
  </varlistentry>
</variablelist>
</para>
</sect2>
</sect1>