1<TITLE>spindate - Create and manipulate time spinner widgets</TITLE>
2<H1>spindate - Create and manipulate time spinner widgets</H1>
3
4</pre><H2>SYNOPSIS</H2>
5<B>spindate<I> <I>pathName </I>?<I>options</I>?
6</pre><H2>INHERITANCE</H2>
7itk::Widget &lt;- Spindate
8
9</pre><H2>STANDARD OPTIONS</H2>
10<P>
11<table cellpadding=5>
12<td valign=top>
13<B>background</B><br>
14</td>
15<td valign=top>
16<B>cursor</B><br>
17</td>
18<td valign=top>
19<B>foreground</B><br>
20</td>
21<td valign=top>
22<B>relief</B><br>
23</td>
24</table>
25<P>
26See the <A HREF="http://www.sco.com/Technology/tcl/man/tk_man/options.n.html"> "options" </A> manual entry for details on the standard options.
27</pre><H2>ASSOCIATED OPTIONS</H2>
28<P>
29<table cellpadding=5>
30<td valign=top>
31<B>textBackground</B><br>
32</td>
33<td valign=top>
34<B>textFont</B><br>
35</td>
36<td valign=top>
37</td>
38<td valign=top>
39</td>
40</table>
41<P>
42See the <A HREF="entryfield.n.html"> "entryfield" </A> manual entry for details on the above associated options.
43<P>
44<table cellpadding=5>
45<td valign=top>
46<B>labelFont</B><br>
47</td>
48<td valign=top>
49<B>labelMargin</B><br>
50</td>
51<td valign=top>
52</td>
53<td valign=top>
54</td>
55</table>
56<P>
57See the <A HREF="labeledwidget.n.html"> "labeledwidget" </A> manual entry for details on the above associated 
58options.
59<P>
60<table cellpadding=5>
61<td valign=top>
62<B>arrowOrient</B><br>
63</td>
64<td valign=top>
65<B>repeatDelay</B><br>
66</td>
67<td valign=top>
68<B>repeatInterval</B><br>
69</td>
70<td valign=top>
71</td>
72</table>
73<P>
74See the <A HREF="spinner.n.html"> "spinner" </A> manual entry for details on the above associated options.
75
76</pre><H2>WIDGET-SPECIFIC OPTIONS</H2>
77<P>
78<pre>
79Name:                   <B>dateMargin</B>
80Class:                  <B>Margin</B>
81Command-Line Switch:	<B>-datemargin</B>
82</pre>
83<UL>
84Specifies the margin space between the month, day, and year spinners is 
85any of the forms accpetable to <B>Tcl_GetPixels</B>.  The default is 1 pixel.
86</UL>
87<P>
88<pre>
89Name:                   <B>dayLabel</B>
90Class:                  <B>Text</B>
91Command-Line Switch:	<B>-daylabel</B>
92</pre>
93<UL>
94Specifies the text of the label for the day spinner.  The default is
95"Day".
96</UL>
97<P>
98<pre>
99Name:                   <B>dayOn</B>
100Class:                  <B>dayOn</B>
101Command-Line Switch:	<B>-dayon</B>
102</pre>
103<UL>
104Specifies whether or not to display the day spinner in any of the forms
105acceptable to <B>Tcl_GetBoolean</B>.  The default is true.
106</UL>
107<P>
108<pre>
109Name:                   <B>dayWidth</B>
110Class:                  <B>Width</B>
111Command-Line Switch:	<B>-daywidth</B>
112</pre>
113<UL>
114Specifies the width of the day spinner in any of the forms acceptable to
115<B>Tcl_GetPixels</B>.  The default is 3 pixels.
116</UL>
117<P>
118<pre>
119Name:                   <B>labelPos</B>
120Class:                  <B>Position</B>
121Command-Line Switch:	<B>-labelpos</B>
122</pre>
123<UL>
124Specifies the position of the label along the sides of the various 
125spinners: <B>n</B>, <B>e</B>, <B>s</B>, or <B>w</B>.  The default is w.
126</UL>
127<P>
128<pre>
129Name:                   <B>monthFormat</B>
130Class:                  <B>MonthFormat</B>
131Command-Line Switch:	<B>-monthformat</B>
132</pre>
133<UL>
134Specifies the format of month display, <B>integer</B> (1-12) or <B>brief</B>
135strings (Jan - Dec), or <B>full</B> strings (January - December).
136</UL>
137<P>
138<pre>
139Name:                   <B>monthLabel</B>
140Class:                  <B>Text</B>
141Command-Line Switch:	<B>-monthlabel</B>
142</pre>
143<UL>
144Specifies the text of the label for the month spinner.  The default is "Month".
145</UL>
146<P>
147<pre>
148Name:                   <B>monthOn</B>
149Class:                  <B>monthOn</B>
150Command-Line Switch:	<B>-monthon</B>
151</pre>
152<UL>
153Specifies whether or not to display the month spinner in any of the forms
154acceptable to <B>Tcl_GetBoolean</B>.  The default is true.
155</UL>
156<P>
157<pre>
158Name:                   <B>monthWidth</B>
159Class:                  <B>Width</B>
160Command-Line Switch:	<B>-monthwidth</B>
161</pre>
162<UL>
163Specifies the width of the month spinner in any of the forms acceptable to
164<B>Tcl_GetPixels</B>.  The default is 3 pixels.
165</UL>
166<P>
167<pre>
168Name:                   <B>orient</B>
169Class:                  <B>Orient</B>
170Command-Line Switch:	<B>-orient</B>
171</pre>
172<UL>
173Specifies the orientation of the month, day, and year spinners: <B>vertical</B> or <B>horizontal</B>.  The default is horizontal.
174</UL>
175<P>
176<pre>
177Name:                   <B>yearDigits</B>
178Class:                  <B>YearDigits</B>
179Command-Line Switch:	<B>-yeardigits</B>
180</pre>
181<UL>
182Specifies the number of digits to be displayed as the value for the year 
183spinner.  The valid values are 2 and 4.  The default is 2.
184</UL>
185<P>
186<pre>
187Name:                   <B>yearLabel</B>
188Class:                  <B>Text</B>
189Command-Line Switch:	<B>-yearlabel</B>
190</pre>
191<UL>
192Specifies the text of the label for the year spinner.  The default is
193"Year"
194</UL>
195<P>
196<pre>
197Name:                   <B>yearOn</B>
198Class:                  <B>yearOn</B>
199Command-Line Switch:	<B>-yearon</B>
200</pre>
201<UL>
202Specifies whether or not to display the year spinner in any of the forms
203acceptable to <B>Tcl_GetBoolean</B>.  The default is true.
204</UL>
205<P>
206<pre>
207Name:                   <B>yearWidth</B>
208Class:                  <B>Width</B>
209Command-Line Switch:	<B>-yearwidth</B>
210</pre>
211<UL>
212Specifies the width of the year spinner in any of the forms acceptable to
213<B>Tcl_GetPixels</B>.  The default is 3 pixels.
214</UL>
215<P>
216<table cellpadding=5>
217<td valign=top>
218</pre><HR><br>
219<B>spindate</B><br>
220set<br>
221use<br>
222entry.<br>
223an<br>
224year<br>
225<P><br>
226creates<br>
227command<br>
228<I>pathName</I>.<br>
229be<br>
230various<br>
231widget.<br>
232following<br>
233<I>pathName<br>
234...</I>?<br>
235the<br>
236exact<br>
237command.<br>
238are<br>
239widgets:<br>
240<DT><br>
241</I></B><br>
242current<br>
243configuration<br>
244<I>option</I>.<br>
245any<br>
246accepted<br>
247command.<br>
248<I>pathName</I><br>
249option<br>
250<DD><br>
251the<br>
252the<br>
253<I>option</I><br>
254a<br>
255of<br>
256for<br>
257for<br>
258format<br>
259If<br>
260with<br>
261the<br>
262list<br>
263named<br>
264will<br>
265the<br>
266the<br>
267no<br>
268If<br>
269<I>option-value</I><br>
270then<br>
271the<br>
272to<br>
273value(s);<br>
274the<br>
275empty<br>
276have<br>
277values<br>
278<B>spindate</B><br>
279<DT><br>
280</I></B><br>
281current<br>
282spindate<br>
283format<br>
284as<br>
285value<br>
286and<br>
287respectively.<br>
288by<br>
289clock<br>
290information<br>
291and<br>
292<DL><br>
293<I>date</I><br>
294the<br>
295to<br>
296the<br>
297date<br>
298either<br>
299an<br>
300or<br>
301Reference<br>
302for<br>
303obtaining<br>
304formats.<br>
305<table><br>
306<B>Spinner</B><br>
307</td>
308<td valign=top>
309</pre><H2>DESCRIPTION</H2><br>
310command<br>
311of<br>
312in<br>
313The<br>
314month,<br>
315spinner<br>
316The<br>
317a<br>
318whose<br>
319This<br>
320used<br>
321operations<br>
322It<br>
323general<br>
324option<br>
325</pre><br>
326<I>arg</I>s<br>
327behavior<br>
328The<br>
329possible<br>
330</pre><H2>WIDGET-SPECIFIC<br>
331<I>pathName<br>
332<DD><br>
333value<br>
334option<br>
335<I>Option</I><br>
336of<br>
337by<br>
338</DL><br>
339<B>configure</B><br>
340value<br>
341Query<br>
342configuration<br>
343widget.<br>
344is<br>
345list<br>
346the<br>
347<I>pathName</I><br>
348information<br>
349of<br>
350<I>option</I><br>
351no<br>
352command<br>
353describing<br>
354option<br>
355be<br>
356corresponding<br>
357value<br>
358<I>option</I><br>
359one<br>
360pairs<br>
361the<br>
362given<br>
363have<br>
364in<br>
365command<br>
366string.<br>
367any<br>
368accepted<br>
369command.<br>
370<I>pathName<br>
371<DD><br>
372contents<br>
373widget<br>
374of<br>
375an<br>
376using<br>
377<B>-clicks</B><br>
378The<br>
379string.<br>
380command<br>
381on<br>
382their<br>
383<DT><br>
384</I></B><br>
385currently<br>
386be<br>
387date<br>
388may<br>
389as<br>
390integer<br>
391the<br>
392the<br>
393more<br>
394dates<br>
395</DL><br>
396Name:<br>
397</td>
398<td valign=top>
399<P><br>
400creates<br>
401spinners<br>
402date<br>
403set<br>
404day,<br>
405widget.<br>
406<B>spindate</B><br>
407new<br>
408name<br>
409command<br>
410to<br>
411on<br>
412has<br>
413form:<br>
414</I>?<I>arg<br>
415<I>Option</I><br>
416determine<br>
417of<br>
418following<br>
419for<br>
420METHODS</H2><br>
421<B>cget</B><br>
422Returns<br>
423of<br>
424given<br>
425may<br>
426the<br>
427the<br>
428<DL><br>
429?<I>option</I>?<br>
430...</I>?<br>
431or<br>
432options<br>
433If<br>
434specified,<br>
435describing<br>
436available<br>
437(see<br>
438on<br>
439this<br>
440is<br>
441<I>value</I>,<br>
442returns<br>
443the<br>
444(this<br>
445identical<br>
446sublist<br>
447returned<br>
448is<br>
449or<br>
450are<br>
451command<br>
452widget<br>
453the<br>
454this<br>
455returns<br>
456<I>Option</I><br>
457of<br>
458by<br>
459</DL><br>
460<B>get</B><br>
461Returns<br>
462of<br>
463in<br>
464string<br>
465integer<br>
466the<br>
467format<br>
468default<br>
469Reference<br>
470for<br>
471obtaining<br>
472formats.<br>
473<I>pathName<br>
474<DD><br>
475displayed<br>
476that<br>
477argument.<br>
478be<br>
479a<br>
480clock<br>
481keyword<br>
482clock<br>
483information<br>
484and<br>
485</pre><H2>COMPONENTS</H2><br>
486<B>month</B><br>
487</td>
488<td valign=top>
489The<br>
490a<br>
491for<br>
492value<br>
493includes<br>
494and<br>
495</pre><H2>METHODS</H2><br>
496command<br>
497Tcl<br>
498is<br>
499may<br>
500invoke<br>
501the<br>
502the<br>
503<pre><br>
504arg<br>
505and<br>
506the<br>
507the<br>
508commands<br>
509spindate<br>
510<DL><br>
511<I>option</I><br>
512the<br>
513the<br>
514by<br>
515have<br>
516values<br>
517<B>spindate</B><br>
518<DT><br>
519?<I>value<br>
520</I></B><br>
521modify<br>
522of<br>
523no<br>
524returns<br>
525all<br>
526options<br>
527<B>Tk_ConfigureInfo</B><br>
528the<br>
529list).<br>
530specified<br>
531then<br>
532a<br>
533one<br>
534list<br>
535to<br>
536of<br>
537if<br>
538specified).<br>
539more<br>
540specified,<br>
541modifies<br>
542option(s)<br>
543given<br>
544case<br>
545an<br>
546may<br>
547the<br>
548the<br>
549<DL><br>
550?<B>format</B>?<br>
551the<br>
552the<br>
553a<br>
554or<br>
555clock<br>
556<B>-string</B><br>
557options<br>
558is<br>
559the<br>
560more<br>
561dates<br>
562</DL><br>
563<B>show</B><br>
564Changes<br>
565date<br>
566of<br>
567The<br>
568specified<br>
569string,<br>
570value<br>
571"now".<br>
572command<br>
573on<br>
574their<br>
575<P><br>
576Class:<br>
577</td>
578</table>
579<UL>
580The month spinner component is the month spinner of the date spinner.
581See the Spinner widget manual entry for details on the month component item.
582</UL>
583<P>
584<pre>
585Name:                   <B>day</B>
586Class:                  <B>Spinint</B>
587</pre>
588<UL>
589The day spinner component is the day spinner of the date spinner.
590See the SpinInt widget manual entry for details on the day component item.
591</UL>
592<P>
593<pre>
594Name:                   <B>year</B>
595Class:                  <B>Spinint</B>
596</pre>
597<UL>
598The year spinner component is the year spinner of the date spinner.
599See the SpinInt widget manual entry for	details on the year component item.
600</UL>
601</table>
602
603</pre><H2>EXAMPLE</H2>
604<pre>
605spindate .sd
606pack .sd -padx 10 -pady 10
607</pre>
608</pre><H2>AUTHORS</H2>
609Sue Yockey
610<P>
611Mark L. Ulferts
612</pre><H2>KEYWORDS</H2>
613spindate, spinint, spinner, entryfield, entry, widget
614
615