You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
615 lines
9.9 KiB
HTML
615 lines
9.9 KiB
HTML
15 years ago
|
<TITLE>spindate - Create and manipulate time spinner widgets</TITLE>
|
||
|
|
<H1>spindate - Create and manipulate time spinner widgets</H1>
|
||
|
|
|
||
|
|
</pre><H2>SYNOPSIS</H2>
|
||
|
|
<B>spindate<I> <I>pathName </I>?<I>options</I>?
|
||
|
|
</pre><H2>INHERITANCE</H2>
|
||
|
|
itk::Widget <- Spindate
|
||
|
|
|
||
|
|
</pre><H2>STANDARD OPTIONS</H2>
|
||
|
|
<P>
|
||
|
|
<table cellpadding=5>
|
||
|
|
<td valign=top>
|
||
|
|
<B>background</B><br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
<B>cursor</B><br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
<B>foreground</B><br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
<B>relief</B><br>
|
||
|
|
</td>
|
||
|
|
</table>
|
||
|
|
<P>
|
||
|
|
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.
|
||
|
|
</pre><H2>ASSOCIATED OPTIONS</H2>
|
||
|
|
<P>
|
||
|
|
<table cellpadding=5>
|
||
|
|
<td valign=top>
|
||
|
|
<B>textBackground</B><br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
<B>textFont</B><br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
</td>
|
||
|
|
</table>
|
||
|
|
<P>
|
||
|
|
See the <A HREF="entryfield.n.html"> "entryfield" </A> manual entry for details on the above associated options.
|
||
|
|
<P>
|
||
|
|
<table cellpadding=5>
|
||
|
|
<td valign=top>
|
||
|
|
<B>labelFont</B><br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
<B>labelMargin</B><br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
</td>
|
||
|
|
</table>
|
||
|
|
<P>
|
||
|
|
See the <A HREF="labeledwidget.n.html"> "labeledwidget" </A> manual entry for details on the above associated
|
||
|
|
options.
|
||
|
|
<P>
|
||
|
|
<table cellpadding=5>
|
||
|
|
<td valign=top>
|
||
|
|
<B>arrowOrient</B><br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
<B>repeatDelay</B><br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
<B>repeatInterval</B><br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
</td>
|
||
|
|
</table>
|
||
|
|
<P>
|
||
|
|
See the <A HREF="spinner.n.html"> "spinner" </A> manual entry for details on the above associated options.
|
||
|
|
|
||
|
|
</pre><H2>WIDGET-SPECIFIC OPTIONS</H2>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>dateMargin</B>
|
||
|
|
Class: <B>Margin</B>
|
||
|
|
Command-Line Switch: <B>-datemargin</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies the margin space between the month, day, and year spinners is
|
||
|
|
any of the forms accpetable to <B>Tcl_GetPixels</B>. The default is 1 pixel.
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>dayLabel</B>
|
||
|
|
Class: <B>Text</B>
|
||
|
|
Command-Line Switch: <B>-daylabel</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies the text of the label for the day spinner. The default is
|
||
|
|
"Day".
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>dayOn</B>
|
||
|
|
Class: <B>dayOn</B>
|
||
|
|
Command-Line Switch: <B>-dayon</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies whether or not to display the day spinner in any of the forms
|
||
|
|
acceptable to <B>Tcl_GetBoolean</B>. The default is true.
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>dayWidth</B>
|
||
|
|
Class: <B>Width</B>
|
||
|
|
Command-Line Switch: <B>-daywidth</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies the width of the day spinner in any of the forms acceptable to
|
||
|
|
<B>Tcl_GetPixels</B>. The default is 3 pixels.
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>labelPos</B>
|
||
|
|
Class: <B>Position</B>
|
||
|
|
Command-Line Switch: <B>-labelpos</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies the position of the label along the sides of the various
|
||
|
|
spinners: <B>n</B>, <B>e</B>, <B>s</B>, or <B>w</B>. The default is w.
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>monthFormat</B>
|
||
|
|
Class: <B>MonthFormat</B>
|
||
|
|
Command-Line Switch: <B>-monthformat</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies the format of month display, <B>integer</B> (1-12) or <B>brief</B>
|
||
|
|
strings (Jan - Dec), or <B>full</B> strings (January - December).
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>monthLabel</B>
|
||
|
|
Class: <B>Text</B>
|
||
|
|
Command-Line Switch: <B>-monthlabel</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies the text of the label for the month spinner. The default is "Month".
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>monthOn</B>
|
||
|
|
Class: <B>monthOn</B>
|
||
|
|
Command-Line Switch: <B>-monthon</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies whether or not to display the month spinner in any of the forms
|
||
|
|
acceptable to <B>Tcl_GetBoolean</B>. The default is true.
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>monthWidth</B>
|
||
|
|
Class: <B>Width</B>
|
||
|
|
Command-Line Switch: <B>-monthwidth</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies the width of the month spinner in any of the forms acceptable to
|
||
|
|
<B>Tcl_GetPixels</B>. The default is 3 pixels.
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>orient</B>
|
||
|
|
Class: <B>Orient</B>
|
||
|
|
Command-Line Switch: <B>-orient</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies the orientation of the month, day, and year spinners: <B>vertical</B> or <B>horizontal</B>. The default is horizontal.
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>yearDigits</B>
|
||
|
|
Class: <B>YearDigits</B>
|
||
|
|
Command-Line Switch: <B>-yeardigits</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies the number of digits to be displayed as the value for the year
|
||
|
|
spinner. The valid values are 2 and 4. The default is 2.
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>yearLabel</B>
|
||
|
|
Class: <B>Text</B>
|
||
|
|
Command-Line Switch: <B>-yearlabel</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies the text of the label for the year spinner. The default is
|
||
|
|
"Year"
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>yearOn</B>
|
||
|
|
Class: <B>yearOn</B>
|
||
|
|
Command-Line Switch: <B>-yearon</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies whether or not to display the year spinner in any of the forms
|
||
|
|
acceptable to <B>Tcl_GetBoolean</B>. The default is true.
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>yearWidth</B>
|
||
|
|
Class: <B>Width</B>
|
||
|
|
Command-Line Switch: <B>-yearwidth</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
Specifies the width of the year spinner in any of the forms acceptable to
|
||
|
|
<B>Tcl_GetPixels</B>. The default is 3 pixels.
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<table cellpadding=5>
|
||
|
|
<td valign=top>
|
||
|
|
</pre><HR><br>
|
||
|
|
<B>spindate</B><br>
|
||
|
|
set<br>
|
||
|
|
use<br>
|
||
|
|
entry.<br>
|
||
|
|
an<br>
|
||
|
|
year<br>
|
||
|
|
<P><br>
|
||
|
|
creates<br>
|
||
|
|
command<br>
|
||
|
|
<I>pathName</I>.<br>
|
||
|
|
be<br>
|
||
|
|
various<br>
|
||
|
|
widget.<br>
|
||
|
|
following<br>
|
||
|
|
<I>pathName<br>
|
||
|
|
...</I>?<br>
|
||
|
|
the<br>
|
||
|
|
exact<br>
|
||
|
|
command.<br>
|
||
|
|
are<br>
|
||
|
|
widgets:<br>
|
||
|
|
<DT><br>
|
||
|
|
</I></B><br>
|
||
|
|
current<br>
|
||
|
|
configuration<br>
|
||
|
|
<I>option</I>.<br>
|
||
|
|
any<br>
|
||
|
|
accepted<br>
|
||
|
|
command.<br>
|
||
|
|
<I>pathName</I><br>
|
||
|
|
option<br>
|
||
|
|
<DD><br>
|
||
|
|
the<br>
|
||
|
|
the<br>
|
||
|
|
<I>option</I><br>
|
||
|
|
a<br>
|
||
|
|
of<br>
|
||
|
|
for<br>
|
||
|
|
for<br>
|
||
|
|
format<br>
|
||
|
|
If<br>
|
||
|
|
with<br>
|
||
|
|
the<br>
|
||
|
|
list<br>
|
||
|
|
named<br>
|
||
|
|
will<br>
|
||
|
|
the<br>
|
||
|
|
the<br>
|
||
|
|
no<br>
|
||
|
|
If<br>
|
||
|
|
<I>option-value</I><br>
|
||
|
|
then<br>
|
||
|
|
the<br>
|
||
|
|
to<br>
|
||
|
|
value(s);<br>
|
||
|
|
the<br>
|
||
|
|
empty<br>
|
||
|
|
have<br>
|
||
|
|
values<br>
|
||
|
|
<B>spindate</B><br>
|
||
|
|
<DT><br>
|
||
|
|
</I></B><br>
|
||
|
|
current<br>
|
||
|
|
spindate<br>
|
||
|
|
format<br>
|
||
|
|
as<br>
|
||
|
|
value<br>
|
||
|
|
and<br>
|
||
|
|
respectively.<br>
|
||
|
|
by<br>
|
||
|
|
clock<br>
|
||
|
|
information<br>
|
||
|
|
and<br>
|
||
|
|
<DL><br>
|
||
|
|
<I>date</I><br>
|
||
|
|
the<br>
|
||
|
|
to<br>
|
||
|
|
the<br>
|
||
|
|
date<br>
|
||
|
|
either<br>
|
||
|
|
an<br>
|
||
|
|
or<br>
|
||
|
|
Reference<br>
|
||
|
|
for<br>
|
||
|
|
obtaining<br>
|
||
|
|
formats.<br>
|
||
|
|
<table><br>
|
||
|
|
<B>Spinner</B><br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
</pre><H2>DESCRIPTION</H2><br>
|
||
|
|
command<br>
|
||
|
|
of<br>
|
||
|
|
in<br>
|
||
|
|
The<br>
|
||
|
|
month,<br>
|
||
|
|
spinner<br>
|
||
|
|
The<br>
|
||
|
|
a<br>
|
||
|
|
whose<br>
|
||
|
|
This<br>
|
||
|
|
used<br>
|
||
|
|
operations<br>
|
||
|
|
It<br>
|
||
|
|
general<br>
|
||
|
|
option<br>
|
||
|
|
</pre><br>
|
||
|
|
<I>arg</I>s<br>
|
||
|
|
behavior<br>
|
||
|
|
The<br>
|
||
|
|
possible<br>
|
||
|
|
</pre><H2>WIDGET-SPECIFIC<br>
|
||
|
|
<I>pathName<br>
|
||
|
|
<DD><br>
|
||
|
|
value<br>
|
||
|
|
option<br>
|
||
|
|
<I>Option</I><br>
|
||
|
|
of<br>
|
||
|
|
by<br>
|
||
|
|
</DL><br>
|
||
|
|
<B>configure</B><br>
|
||
|
|
value<br>
|
||
|
|
Query<br>
|
||
|
|
configuration<br>
|
||
|
|
widget.<br>
|
||
|
|
is<br>
|
||
|
|
list<br>
|
||
|
|
the<br>
|
||
|
|
<I>pathName</I><br>
|
||
|
|
information<br>
|
||
|
|
of<br>
|
||
|
|
<I>option</I><br>
|
||
|
|
no<br>
|
||
|
|
command<br>
|
||
|
|
describing<br>
|
||
|
|
option<br>
|
||
|
|
be<br>
|
||
|
|
corresponding<br>
|
||
|
|
value<br>
|
||
|
|
<I>option</I><br>
|
||
|
|
one<br>
|
||
|
|
pairs<br>
|
||
|
|
the<br>
|
||
|
|
given<br>
|
||
|
|
have<br>
|
||
|
|
in<br>
|
||
|
|
command<br>
|
||
|
|
string.<br>
|
||
|
|
any<br>
|
||
|
|
accepted<br>
|
||
|
|
command.<br>
|
||
|
|
<I>pathName<br>
|
||
|
|
<DD><br>
|
||
|
|
contents<br>
|
||
|
|
widget<br>
|
||
|
|
of<br>
|
||
|
|
an<br>
|
||
|
|
using<br>
|
||
|
|
<B>-clicks</B><br>
|
||
|
|
The<br>
|
||
|
|
string.<br>
|
||
|
|
command<br>
|
||
|
|
on<br>
|
||
|
|
their<br>
|
||
|
|
<DT><br>
|
||
|
|
</I></B><br>
|
||
|
|
currently<br>
|
||
|
|
be<br>
|
||
|
|
date<br>
|
||
|
|
may<br>
|
||
|
|
as<br>
|
||
|
|
integer<br>
|
||
|
|
the<br>
|
||
|
|
the<br>
|
||
|
|
more<br>
|
||
|
|
dates<br>
|
||
|
|
</DL><br>
|
||
|
|
Name:<br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
<P><br>
|
||
|
|
creates<br>
|
||
|
|
spinners<br>
|
||
|
|
date<br>
|
||
|
|
set<br>
|
||
|
|
day,<br>
|
||
|
|
widget.<br>
|
||
|
|
<B>spindate</B><br>
|
||
|
|
new<br>
|
||
|
|
name<br>
|
||
|
|
command<br>
|
||
|
|
to<br>
|
||
|
|
on<br>
|
||
|
|
has<br>
|
||
|
|
form:<br>
|
||
|
|
</I>?<I>arg<br>
|
||
|
|
<I>Option</I><br>
|
||
|
|
determine<br>
|
||
|
|
of<br>
|
||
|
|
following<br>
|
||
|
|
for<br>
|
||
|
|
METHODS</H2><br>
|
||
|
|
<B>cget</B><br>
|
||
|
|
Returns<br>
|
||
|
|
of<br>
|
||
|
|
given<br>
|
||
|
|
may<br>
|
||
|
|
the<br>
|
||
|
|
the<br>
|
||
|
|
<DL><br>
|
||
|
|
?<I>option</I>?<br>
|
||
|
|
...</I>?<br>
|
||
|
|
or<br>
|
||
|
|
options<br>
|
||
|
|
If<br>
|
||
|
|
specified,<br>
|
||
|
|
describing<br>
|
||
|
|
available<br>
|
||
|
|
(see<br>
|
||
|
|
on<br>
|
||
|
|
this<br>
|
||
|
|
is<br>
|
||
|
|
<I>value</I>,<br>
|
||
|
|
returns<br>
|
||
|
|
the<br>
|
||
|
|
(this<br>
|
||
|
|
identical<br>
|
||
|
|
sublist<br>
|
||
|
|
returned<br>
|
||
|
|
is<br>
|
||
|
|
or<br>
|
||
|
|
are<br>
|
||
|
|
command<br>
|
||
|
|
widget<br>
|
||
|
|
the<br>
|
||
|
|
this<br>
|
||
|
|
returns<br>
|
||
|
|
<I>Option</I><br>
|
||
|
|
of<br>
|
||
|
|
by<br>
|
||
|
|
</DL><br>
|
||
|
|
<B>get</B><br>
|
||
|
|
Returns<br>
|
||
|
|
of<br>
|
||
|
|
in<br>
|
||
|
|
string<br>
|
||
|
|
integer<br>
|
||
|
|
the<br>
|
||
|
|
format<br>
|
||
|
|
default<br>
|
||
|
|
Reference<br>
|
||
|
|
for<br>
|
||
|
|
obtaining<br>
|
||
|
|
formats.<br>
|
||
|
|
<I>pathName<br>
|
||
|
|
<DD><br>
|
||
|
|
displayed<br>
|
||
|
|
that<br>
|
||
|
|
argument.<br>
|
||
|
|
be<br>
|
||
|
|
a<br>
|
||
|
|
clock<br>
|
||
|
|
keyword<br>
|
||
|
|
clock<br>
|
||
|
|
information<br>
|
||
|
|
and<br>
|
||
|
|
</pre><H2>COMPONENTS</H2><br>
|
||
|
|
<B>month</B><br>
|
||
|
|
</td>
|
||
|
|
<td valign=top>
|
||
|
|
The<br>
|
||
|
|
a<br>
|
||
|
|
for<br>
|
||
|
|
value<br>
|
||
|
|
includes<br>
|
||
|
|
and<br>
|
||
|
|
</pre><H2>METHODS</H2><br>
|
||
|
|
command<br>
|
||
|
|
Tcl<br>
|
||
|
|
is<br>
|
||
|
|
may<br>
|
||
|
|
invoke<br>
|
||
|
|
the<br>
|
||
|
|
the<br>
|
||
|
|
<pre><br>
|
||
|
|
arg<br>
|
||
|
|
and<br>
|
||
|
|
the<br>
|
||
|
|
the<br>
|
||
|
|
commands<br>
|
||
|
|
spindate<br>
|
||
|
|
<DL><br>
|
||
|
|
<I>option</I><br>
|
||
|
|
the<br>
|
||
|
|
the<br>
|
||
|
|
by<br>
|
||
|
|
have<br>
|
||
|
|
values<br>
|
||
|
|
<B>spindate</B><br>
|
||
|
|
<DT><br>
|
||
|
|
?<I>value<br>
|
||
|
|
</I></B><br>
|
||
|
|
modify<br>
|
||
|
|
of<br>
|
||
|
|
no<br>
|
||
|
|
returns<br>
|
||
|
|
all<br>
|
||
|
|
options<br>
|
||
|
|
<B>Tk_ConfigureInfo</B><br>
|
||
|
|
the<br>
|
||
|
|
list).<br>
|
||
|
|
specified<br>
|
||
|
|
then<br>
|
||
|
|
a<br>
|
||
|
|
one<br>
|
||
|
|
list<br>
|
||
|
|
to<br>
|
||
|
|
of<br>
|
||
|
|
if<br>
|
||
|
|
specified).<br>
|
||
|
|
more<br>
|
||
|
|
specified,<br>
|
||
|
|
modifies<br>
|
||
|
|
option(s)<br>
|
||
|
|
given<br>
|
||
|
|
case<br>
|
||
|
|
an<br>
|
||
|
|
may<br>
|
||
|
|
the<br>
|
||
|
|
the<br>
|
||
|
|
<DL><br>
|
||
|
|
?<B>format</B>?<br>
|
||
|
|
the<br>
|
||
|
|
the<br>
|
||
|
|
a<br>
|
||
|
|
or<br>
|
||
|
|
clock<br>
|
||
|
|
<B>-string</B><br>
|
||
|
|
options<br>
|
||
|
|
is<br>
|
||
|
|
the<br>
|
||
|
|
more<br>
|
||
|
|
dates<br>
|
||
|
|
</DL><br>
|
||
|
|
<B>show</B><br>
|
||
|
|
Changes<br>
|
||
|
|
date<br>
|
||
|
|
of<br>
|
||
|
|
The<br>
|
||
|
|
specified<br>
|
||
|
|
string,<br>
|
||
|
|
value<br>
|
||
|
|
"now".<br>
|
||
|
|
command<br>
|
||
|
|
on<br>
|
||
|
|
their<br>
|
||
|
|
<P><br>
|
||
|
|
Class:<br>
|
||
|
|
</td>
|
||
|
|
</table>
|
||
|
|
<UL>
|
||
|
|
The month spinner component is the month spinner of the date spinner.
|
||
|
|
See the Spinner widget manual entry for details on the month component item.
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>day</B>
|
||
|
|
Class: <B>Spinint</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
The day spinner component is the day spinner of the date spinner.
|
||
|
|
See the SpinInt widget manual entry for details on the day component item.
|
||
|
|
</UL>
|
||
|
|
<P>
|
||
|
|
<pre>
|
||
|
|
Name: <B>year</B>
|
||
|
|
Class: <B>Spinint</B>
|
||
|
|
</pre>
|
||
|
|
<UL>
|
||
|
|
The year spinner component is the year spinner of the date spinner.
|
||
|
|
See the SpinInt widget manual entry for details on the year component item.
|
||
|
|
</UL>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
</pre><H2>EXAMPLE</H2>
|
||
|
|
<pre>
|
||
|
|
spindate .sd
|
||
|
|
pack .sd -padx 10 -pady 10
|
||
|
|
</pre>
|
||
|
|
</pre><H2>AUTHORS</H2>
|
||
|
|
Sue Yockey
|
||
|
|
<P>
|
||
|
|
Mark L. Ulferts
|
||
|
|
</pre><H2>KEYWORDS</H2>
|
||
|
|
spindate, spinint, spinner, entryfield, entry, widget
|
||
|
|
|