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 <- 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