1<sect1 id="SmeLine_Object">
2<title>SmeLine Object</title>
3<para>
4<!-- .LP -->
5<!-- .XS -->
6<!-- 	SmeLine Object -->
7<!-- .XE -->
8<indexterm significance="preferred"><primary>SmeLine object</primary></indexterm>
9<!-- .sp -->
10<literallayout class="monospaced">
11<!-- .TA 2.0i -->
12<!-- .ta 2.0i -->
13Application Header file	&lt;X11/Xaw/SmeLine.h&gt;
14<indexterm><primary>SmeLine.h</primary></indexterm>
15Class Header file	&lt;X11/Xaw/SmeLineP.h&gt;
16<indexterm><primary>SmeLineP.h</primary></indexterm>
17Class		smeLineObjectClass
18<indexterm><primary>smeLineObjectClass</primary></indexterm>
19Class Name	SmeLine
20<indexterm><primary>SmeLine object</primary><secondary>class name</secondary></indexterm>
21Superclass	Sme
22</literallayout>
23<!-- .sp -->
24</para>
25<para>
26<!-- .LP -->
27The SmeLine object is used to add a horizontal line or menu separator to
28a menu.  Since each SmeLine is an independent object, the application
29is able to change the color, height, and other attributes of the SmeLine
30objects on an entry by entry basis.  This object is not selectable, and
31will not highlight when the pointer cursor is over it.
32</para>
33<sect2 id='SmeLine::Resources'>
34<title>Resources</title>
35<indexterm><primary>SmeLine object</primary><secondary>resources</secondary></indexterm>
36<para>
37<!-- .LP -->
38The resources associated with the SmeLine object are defined in this section,
39and affect only the single menu entry specified by this object.
40<informaltable>
41  <tgroup cols='5' align='center'>
42  <colspec colname='c1'/>
43  <colspec colname='c2'/>
44  <colspec colname='c3'/>
45  <colspec colname='c4'/>
46  <colspec colname='c5'/>
47  <thead>
48    <row>
49      <entry>Name</entry>
50      <entry>Class</entry>
51      <entry>Type</entry>
52      <entry>Notes</entry>
53      <entry>Default Value</entry>
54    </row>
55  </thead>
56  <tbody>
57    <row>
58      <entry>destroyCallback</entry>
59      <entry>Callback</entry>
60      <entry>XtCallbackList</entry>
61      <entry></entry>
62      <entry>NULL</entry>
63    </row>
64    <row>
65      <entry>foreground</entry>
66      <entry>Foreground</entry>
67      <entry>Pixel</entry>
68      <entry></entry>
69      <entry>XtDefaultForeground</entry>
70    </row>
71    <row>
72      <entry>height</entry>
73      <entry>Height</entry>
74      <entry>Dimension</entry>
75      <entry></entry>
76      <entry><function>lineWidth</function></entry>
77    </row>
78    <row>
79      <entry>international</entry>
80      <entry>International</entry>
81      <entry>Boolean</entry>
82      <entry>C</entry>
83      <entry>False</entry>
84    </row>
85    <row>
86      <entry>lineWidth</entry>
87      <entry>LineWidth</entry>
88      <entry>Dimension</entry>
89      <entry></entry>
90      <entry>1</entry>
91    </row>
92    <row>
93      <entry>stipple</entry>
94      <entry>Stipple</entry>
95      <entry>Pixmap</entry>
96      <entry></entry>
97      <entry>XtUnspecifiedPixmap</entry>
98    </row>
99    <row>
100      <entry>width</entry>
101      <entry>Width</entry>
102      <entry>Dimension</entry>
103      <entry></entry>
104      <entry>1</entry>
105    </row>
106  </tbody>
107  </tgroup>
108</informaltable>
109<!-- .Dc -->
110<variablelist>
111  <varlistentry>
112    <term>foreground</term>
113    <listitem>
114      <para>
115A pixel value which indexes the SimpleMenu's colormap to derive the
116foreground color used to draw the separator line.
117<!-- .Hw -->
118Keep in mind that the SimpleMenu widget will force all menu items to
119be the width of the widest entry.  Thus, setting the width is generally not
120very important.
121<!-- .Ix -->
122      </para>
123    </listitem>
124  </varlistentry>
125  <varlistentry>
126    <term>lineWidth</term>
127    <listitem>
128      <para>
129The width of the horizontal line that is to be displayed.
130      </para>
131    </listitem>
132  </varlistentry>
133
134  <varlistentry>
135    <term>stipple</term>
136    <listitem>
137      <para>
138If a bitmap is specified for this resource, the line will be stippled
139through it.  This allows the menu separator to be rendered as something
140more exciting than just a line.  For instance, if you define a stipple
141that is a chain link, then your menu separators will look like chains.
142      </para>
143    </listitem>
144  </varlistentry>
145</variablelist>
146</para>
147</sect2>
148</sect1>
149