1<TITLE>spintime - Create and manipulate time spinner widgets</TITLE> 2<H1>spintime - Create and manipulate time spinner widgets</H1> 3 4</pre><H2>SYNOPSIS</H2> 5<B>spintime<I> <I>pathName </I>?<I>options</I>? 6</pre><H2>INHERITANCE</H2> 7itk::Widget <- Spintime 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>labelPos</B> 80Class: <B>Position</B> 81Command-Line Switch: <B>-labelpos</B> 82</pre> 83<UL> 84Specifies the position of the label along the sides of the various 85spinners: <B>n</B>, <B>e</B>, <B>s</B>, or <B>w</B>. The default is w. 86</UL> 87<P> 88<pre> 89Name: <B>hourLabel</B> 90Class: <B>Text</B> 91Command-Line Switch: <B>-hourlabel</B> 92</pre> 93<UL> 94Specifies the text of the label for the hour spinner. The default is "Hour". 95</UL> 96<P> 97<pre> 98Name: <B>hourOn</B> 99Class: <B>hourOn</B> 100Command-Line Switch: <B>-houron</B> 101</pre> 102<UL> 103Specifies whether or not to display the hour spinner in any of the forms 104acceptable to <B>Tcl_GetBoolean</B>. The default is true. 105</UL> 106<P> 107<pre> 108Name: <B>hourWidth</B> 109Class: <B>Width</B> 110Command-Line Switch: <B>-hourwidth</B> 111</pre> 112<UL> 113Specifies the width of the hour spinner in any of the forms acceptable to 114<B>Tcl_GetPixels</B>. The default is 3 pixels. 115</UL> 116<P> 117<pre> 118Name: <B>militaryOn</B> 119Class: <B>militaryOn</B> 120Command-Line Switch: <B>-militaryon</B> 121</pre> 122<UL> 123Specifies use of a 24 hour clock for hour display in any of the forms 124acceptable to <B>Tcl_GetBoolean</B>. The default is true. 125</UL> 126<P> 127<pre> 128Name: <B>minuteLabel</B> 129Class: <B>Text</B> 130Command-Line Switch: <B>-minutelabel</B> 131</pre> 132<UL> 133Specifies the text of the label for the minute spinner. The default is 134"Minute". 135</UL> 136<P> 137<pre> 138Name: <B>minuteOn</B> 139Class: <B>minuteOn</B> 140Command-Line Switch: <B>-minuteon</B> 141</pre> 142<UL> 143Specifies whether or not to display the minute spinner in any of the forms 144acceptable to <B>Tcl_GetBoolean</B>. The default is true. 145</UL> 146<P> 147<pre> 148Name: <B>minuteWidth</B> 149Class: <B>Width</B> 150Command-Line Switch: <B>-minutewidth</B> 151</pre> 152<UL> 153Specifies the width of the minute spinner in any of the forms acceptable to 154<B>Tcl_GetPixels</B>. The default is 3 pixels. 155</UL> 156<P> 157<pre> 158Name: <B>orient</B> 159Class: <B>Orient</B> 160Command-Line Switch: <B>-orient</B> 161</pre> 162<UL> 163Specifies the orientation of the hour, minute, and second spinners: <B>vertical</B> or <B>horizontal</B>. The default is horizontal. 164</UL> 165<P> 166<pre> 167Name: <B>secondLabel</B> 168Class: <B>Text</B> 169Command-Line Switch: <B>-secondlabel</B> 170</pre> 171<UL> 172Specifies the text of the label for the second spinner. The default is 173"Second" 174</UL> 175<P> 176<pre> 177Name: <B>secondOn</B> 178Class: <B>secondOn</B> 179Command-Line Switch: <B>-secondon</B> 180</pre> 181<UL> 182Specifies whether or not to display the second spinner in any of the forms 183acceptable to <B>Tcl_GetBoolean</B>. The default is true. 184</UL> 185<P> 186<pre> 187Name: <B>secondWidth</B> 188Class: <B>Width</B> 189Command-Line Switch: <B>-secondwidth</B> 190</pre> 191<UL> 192Specifies the width of the second spinner in any of the forms acceptable to 193<B>Tcl_GetPixels</B>. The default is 3 pixels. 194</UL> 195<P> 196<pre> 197Name: <B>timeMargin</B> 198Class: <B>Margin</B> 199Command-Line Switch: <B>-timemargin</B> 200</pre> 201<UL> 202Specifies the margin space between the hour, minute, and second spinners is 203any of the forms accpetable to <B>Tcl_GetPixels</B>. The default is 1 pixel. 204</UL> 205<P> 206<table cellpadding=5> 207<td valign=top> 208</pre><HR><br> 209<B>spintime</B><br> 210set<br> 211use<br> 212entry.<br> 213an<br> 214second<br> 215<P><br> 216creates<br> 217command<br> 218<I>pathName</I>.<br> 219be<br> 220various<br> 221widget.<br> 222following<br> 223<I>pathName<br> 224...</I>?<br> 225the<br> 226exact<br> 227command.<br> 228are<br> 229widgets:<br> 230<DT><br> 231</I></B><br> 232current<br> 233configuration<br> 234<I>option</I>.<br> 235any<br> 236accepted<br> 237command.<br> 238<I>pathName</I><br> 239option<br> 240<DD><br> 241the<br> 242the<br> 243<I>option</I><br> 244a<br> 245of<br> 246for<br> 247for<br> 248format<br> 249If<br> 250with<br> 251the<br> 252list<br> 253named<br> 254will<br> 255the<br> 256the<br> 257no<br> 258If<br> 259<I>option-value</I><br> 260then<br> 261the<br> 262to<br> 263value(s);<br> 264the<br> 265empty<br> 266have<br> 267values<br> 268<B>spintime</B><br> 269<DT><br> 270</I></B><br> 271current<br> 272spintime<br> 273format<br> 274as<br> 275value<br> 276and<br> 277respectively.<br> 278by<br> 279clock<br> 280information<br> 281and<br> 282<DL><br> 283<I>time</I><br> 284the<br> 285to<br> 286the<br> 287time<br> 288either<br> 289an<br> 290or<br> 291Reference<br> 292for<br> 293obtaining<br> 294format.<br> 295<table><br> 296<B>Spinint</B><br> 297</td> 298<td valign=top> 299</pre><H2>DESCRIPTION</H2><br> 300command<br> 301of<br> 302in<br> 303The<br> 304hour,<br> 305spinner<br> 306The<br> 307a<br> 308whose<br> 309This<br> 310used<br> 311operations<br> 312It<br> 313general<br> 314option<br> 315</pre><br> 316<I>arg</I>s<br> 317behavior<br> 318The<br> 319possible<br> 320</pre><H2>WIDGET-SPECIFIC<br> 321<I>pathName<br> 322<DD><br> 323value<br> 324option<br> 325<I>Option</I><br> 326of<br> 327by<br> 328</DL><br> 329<B>configure</B><br> 330value<br> 331Query<br> 332configuration<br> 333widget.<br> 334is<br> 335list<br> 336the<br> 337<I>pathName</I><br> 338information<br> 339of<br> 340<I>option</I><br> 341no<br> 342command<br> 343describing<br> 344option<br> 345be<br> 346corresponding<br> 347value<br> 348<I>option</I><br> 349one<br> 350pairs<br> 351the<br> 352given<br> 353have<br> 354in<br> 355command<br> 356string.<br> 357any<br> 358accepted<br> 359command.<br> 360<I>pathName<br> 361<DD><br> 362contents<br> 363widget<br> 364of<br> 365an<br> 366using<br> 367<B>-clicks</B><br> 368The<br> 369string.<br> 370command<br> 371on<br> 372its<br> 373<DT><br> 374</I></B><br> 375currently<br> 376be<br> 377time<br> 378may<br> 379as<br> 380integer<br> 381the<br> 382the<br> 383more<br> 384times<br> 385</DL><br> 386Name:<br> 387</td> 388<td valign=top> 389<P><br> 390creates<br> 391spinners<br> 392time<br> 393set<br> 394minute,<br> 395widget.<br> 396<B>spintime</B><br> 397new<br> 398name<br> 399command<br> 400to<br> 401on<br> 402has<br> 403form:<br> 404</I>?<I>arg<br> 405<I>Option</I><br> 406determine<br> 407of<br> 408following<br> 409for<br> 410METHODS</H2><br> 411<B>cget</B><br> 412Returns<br> 413of<br> 414given<br> 415may<br> 416the<br> 417the<br> 418<DL><br> 419?<I>option</I>?<br> 420...</I>?<br> 421or<br> 422options<br> 423If<br> 424specified,<br> 425describing<br> 426available<br> 427(see<br> 428on<br> 429this<br> 430is<br> 431<I>value</I>,<br> 432returns<br> 433the<br> 434(this<br> 435identical<br> 436sublist<br> 437returned<br> 438is<br> 439or<br> 440are<br> 441command<br> 442widget<br> 443the<br> 444this<br> 445returns<br> 446<I>Option</I><br> 447of<br> 448by<br> 449</DL><br> 450<B>get</B><br> 451Returns<br> 452of<br> 453in<br> 454string<br> 455integer<br> 456the<br> 457format<br> 458default<br> 459Reference<br> 460for<br> 461obtaining<br> 462formats.<br> 463<I>pathName<br> 464<DD><br> 465displayed<br> 466that<br> 467argument.<br> 468be<br> 469a<br> 470clock<br> 471keyword<br> 472clock<br> 473information<br> 474and<br> 475</pre><H2>COMPONENTS</H2><br> 476<B>hour</B><br> 477</td> 478<td valign=top> 479The<br> 480a<br> 481for<br> 482value<br> 483includes<br> 484and<br> 485</pre><H2>METHODS</H2><br> 486command<br> 487Tcl<br> 488is<br> 489may<br> 490invoke<br> 491the<br> 492the<br> 493<pre><br> 494arg<br> 495and<br> 496the<br> 497the<br> 498commands<br> 499spintime<br> 500<DL><br> 501<I>option</I><br> 502the<br> 503the<br> 504by<br> 505have<br> 506values<br> 507<B>spintime</B><br> 508<DT><br> 509?<I>value<br> 510</I></B><br> 511modify<br> 512of<br> 513no<br> 514returns<br> 515all<br> 516options<br> 517<B>Tk_ConfigureInfo</B><br> 518the<br> 519list).<br> 520specified<br> 521then<br> 522a<br> 523one<br> 524list<br> 525to<br> 526of<br> 527if<br> 528specified).<br> 529more<br> 530specified,<br> 531modifies<br> 532option(s)<br> 533given<br> 534case<br> 535an<br> 536may<br> 537the<br> 538the<br> 539<DL><br> 540?<B>format</B>?<br> 541the<br> 542the<br> 543a<br> 544or<br> 545clock<br> 546<B>-string</B><br> 547options<br> 548is<br> 549the<br> 550more<br> 551time<br> 552</DL><br> 553<B>show</B><br> 554Changes<br> 555time<br> 556of<br> 557The<br> 558specified<br> 559string,<br> 560value<br> 561"now".<br> 562command<br> 563on<br> 564its<br> 565<P><br> 566Class:<br> 567</td> 568</table> 569<UL> 570The hour component is the hour spinner of the time spinner. See the 571SpinInt widget manual entry for details on the hour component item. 572</UL> 573<P> 574<pre> 575Name: <B>minute</B> 576Class: <B>Spinint</B> 577</pre> 578<UL> 579The minute component is the minute spinner of the time spinner. See 580the SpinInt widget manual entry for details on the minute component item. 581</UL> 582<P> 583<pre> 584Name: <B>second</B> 585Class: <B>Spinint</B> 586</pre> 587<UL> 588The second component is the second spinner of the time spinner. See the 589SpinInt widget manual entry for details on the second component item. 590</UL> 591</table> 592 593</pre><H2>EXAMPLE</H2> 594<pre> 595spintime .st 596pack .st -padx 10 -pady 10 597</pre> 598</pre><H2>AUTHORS</H2> 599Sue Yockey 600<P> 601Mark L. Ulferts 602</pre><H2>KEYWORDS</H2> 603spintime, spinint, spinner, entryfield, entry, widget 604 605