You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
614 lines
9.9 KiB
614 lines
9.9 KiB
<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 |
|
|
|
|