itcl/iwidgets/demos/html/spintime.n.html

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