'\"
|
'\"
|
'\" Copyright (c) 1995 DSC Technologies Corporation
|
'\" Copyright (c) 1995 DSC Technologies Corporation
|
'\"
|
'\"
|
'\" See the file "license.terms" for information on usage and redistribution
|
'\" See the file "license.terms" for information on usage and redistribution
|
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
'\"
|
'\"
|
'\" @(#) spindate.n
|
'\" @(#) spindate.n
|
'\"
|
'\"
|
.so man.macros
|
.so man.macros
|
.HS spindate iwid
|
.HS spindate iwid
|
.BS
|
.BS
|
'\" Note: do not modify the .SH NAME line immediately below!
|
'\" Note: do not modify the .SH NAME line immediately below!
|
.SH NAME
|
.SH NAME
|
spindate \- Create and manipulate time spinner widgets
|
spindate \- Create and manipulate time spinner widgets
|
.SH SYNOPSIS
|
.SH SYNOPSIS
|
\fBspindate\fI \fIpathName \fR?\fIoptions\fR?
|
\fBspindate\fI \fIpathName \fR?\fIoptions\fR?
|
.SH "INHERITANCE"
|
.SH "INHERITANCE"
|
itk::Widget <- Spindate
|
itk::Widget <- Spindate
|
|
|
.SH "STANDARD OPTIONS"
|
.SH "STANDARD OPTIONS"
|
.LP
|
.LP
|
.nf
|
.nf
|
.ta 4c 8c 12c
|
.ta 4c 8c 12c
|
\fBbackground\fR \fBcursor\fR \fBforeground\fR \fBrelief\fR
|
\fBbackground\fR \fBcursor\fR \fBforeground\fR \fBrelief\fR
|
.fi
|
.fi
|
.LP
|
.LP
|
See the "options" manual entry for details on the standard options.
|
See the "options" manual entry for details on the standard options.
|
.SH "ASSOCIATED OPTIONS"
|
.SH "ASSOCIATED OPTIONS"
|
.LP
|
.LP
|
.nf
|
.nf
|
.ta 4c 8c 12c
|
.ta 4c 8c 12c
|
\fBtextBackground\fR \fBtextFont\fR
|
\fBtextBackground\fR \fBtextFont\fR
|
.fi
|
.fi
|
.LP
|
.LP
|
See the "entryfield" manual entry for details on the above associated options.
|
See the "entryfield" manual entry for details on the above associated options.
|
.LP
|
.LP
|
.nf
|
.nf
|
.ta 4c 8c 12c
|
.ta 4c 8c 12c
|
\fBlabelFont\fR \fBlabelMargin\fR
|
\fBlabelFont\fR \fBlabelMargin\fR
|
.fi
|
.fi
|
.LP
|
.LP
|
See the "labeledwidget" manual entry for details on the above associated
|
See the "labeledwidget" manual entry for details on the above associated
|
options.
|
options.
|
.LP
|
.LP
|
.nf
|
.nf
|
.ta 4c 8c 12c
|
.ta 4c 8c 12c
|
\fBarrowOrient\fR \fBrepeatDelay\fR \fBrepeatInterval\fR
|
\fBarrowOrient\fR \fBrepeatDelay\fR \fBrepeatInterval\fR
|
.fi
|
.fi
|
.LP
|
.LP
|
See the "spinner" manual entry for details on the above associated options.
|
See the "spinner" manual entry for details on the above associated options.
|
|
|
.SH "WIDGET-SPECIFIC OPTIONS"
|
.SH "WIDGET-SPECIFIC OPTIONS"
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBdateMargin\fR
|
Name: \fBdateMargin\fR
|
Class: \fBMargin\fR
|
Class: \fBMargin\fR
|
Command-Line Switch: \fB-datemargin\fR
|
Command-Line Switch: \fB-datemargin\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the margin space between the month, day, and year spinners is
|
Specifies the margin space between the month, day, and year spinners is
|
any of the forms accpetable to \fBTcl_GetPixels\fR. The default is 1 pixel.
|
any of the forms accpetable to \fBTcl_GetPixels\fR. The default is 1 pixel.
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBdayLabel\fR
|
Name: \fBdayLabel\fR
|
Class: \fBText\fR
|
Class: \fBText\fR
|
Command-Line Switch: \fB-daylabel\fR
|
Command-Line Switch: \fB-daylabel\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the text of the label for the day spinner. The default is
|
Specifies the text of the label for the day spinner. The default is
|
"Day".
|
"Day".
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBdayOn\fR
|
Name: \fBdayOn\fR
|
Class: \fBdayOn\fR
|
Class: \fBdayOn\fR
|
Command-Line Switch: \fB-dayon\fR
|
Command-Line Switch: \fB-dayon\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies whether or not to display the day spinner in any of the forms
|
Specifies whether or not to display the day spinner in any of the forms
|
acceptable to \fBTcl_GetBoolean\fR. The default is true.
|
acceptable to \fBTcl_GetBoolean\fR. The default is true.
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBdayWidth\fR
|
Name: \fBdayWidth\fR
|
Class: \fBWidth\fR
|
Class: \fBWidth\fR
|
Command-Line Switch: \fB-daywidth\fR
|
Command-Line Switch: \fB-daywidth\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the width of the day spinner in any of the forms acceptable to
|
Specifies the width of the day spinner in any of the forms acceptable to
|
\fBTcl_GetPixels\fR. The default is 3 pixels.
|
\fBTcl_GetPixels\fR. The default is 3 pixels.
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBlabelPos\fR
|
Name: \fBlabelPos\fR
|
Class: \fBPosition\fR
|
Class: \fBPosition\fR
|
Command-Line Switch: \fB-labelpos\fR
|
Command-Line Switch: \fB-labelpos\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the position of the label along the sides of the various
|
Specifies the position of the label along the sides of the various
|
spinners: \fBn\fR, \fBe\fR, \fBs\fR, or \fBw\fR. The default is w.
|
spinners: \fBn\fR, \fBe\fR, \fBs\fR, or \fBw\fR. The default is w.
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBmonthFormat\fR
|
Name: \fBmonthFormat\fR
|
Class: \fBMonthFormat\fR
|
Class: \fBMonthFormat\fR
|
Command-Line Switch: \fB-monthformat\fR
|
Command-Line Switch: \fB-monthformat\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the format of month display, \fBinteger\fR (1-12) or \fBbrief\fR
|
Specifies the format of month display, \fBinteger\fR (1-12) or \fBbrief\fR
|
strings (Jan - Dec), or \fBfull\fR strings (January - December).
|
strings (Jan - Dec), or \fBfull\fR strings (January - December).
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBmonthLabel\fR
|
Name: \fBmonthLabel\fR
|
Class: \fBText\fR
|
Class: \fBText\fR
|
Command-Line Switch: \fB-monthlabel\fR
|
Command-Line Switch: \fB-monthlabel\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the text of the label for the month spinner. The default is "Month".
|
Specifies the text of the label for the month spinner. The default is "Month".
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBmonthOn\fR
|
Name: \fBmonthOn\fR
|
Class: \fBmonthOn\fR
|
Class: \fBmonthOn\fR
|
Command-Line Switch: \fB-monthon\fR
|
Command-Line Switch: \fB-monthon\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies whether or not to display the month spinner in any of the forms
|
Specifies whether or not to display the month spinner in any of the forms
|
acceptable to \fBTcl_GetBoolean\fR. The default is true.
|
acceptable to \fBTcl_GetBoolean\fR. The default is true.
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBmonthWidth\fR
|
Name: \fBmonthWidth\fR
|
Class: \fBWidth\fR
|
Class: \fBWidth\fR
|
Command-Line Switch: \fB-monthwidth\fR
|
Command-Line Switch: \fB-monthwidth\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the width of the month spinner in any of the forms acceptable to
|
Specifies the width of the month spinner in any of the forms acceptable to
|
\fBTcl_GetPixels\fR. The default is 3 pixels.
|
\fBTcl_GetPixels\fR. The default is 3 pixels.
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBorient\fR
|
Name: \fBorient\fR
|
Class: \fBOrient\fR
|
Class: \fBOrient\fR
|
Command-Line Switch: \fB-orient\fR
|
Command-Line Switch: \fB-orient\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the orientation of the month, day, and year spinners: \fBvertical\fR or \fBhorizontal\fR. The default is horizontal.
|
Specifies the orientation of the month, day, and year spinners: \fBvertical\fR or \fBhorizontal\fR. The default is horizontal.
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fByearDigits\fR
|
Name: \fByearDigits\fR
|
Class: \fBYearDigits\fR
|
Class: \fBYearDigits\fR
|
Command-Line Switch: \fB-yeardigits\fR
|
Command-Line Switch: \fB-yeardigits\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the number of digits to be displayed as the value for the year
|
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.
|
spinner. The valid values are 2 and 4. The default is 2.
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fByearLabel\fR
|
Name: \fByearLabel\fR
|
Class: \fBText\fR
|
Class: \fBText\fR
|
Command-Line Switch: \fB-yearlabel\fR
|
Command-Line Switch: \fB-yearlabel\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the text of the label for the year spinner. The default is
|
Specifies the text of the label for the year spinner. The default is
|
"Year"
|
"Year"
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fByearOn\fR
|
Name: \fByearOn\fR
|
Class: \fByearOn\fR
|
Class: \fByearOn\fR
|
Command-Line Switch: \fB-yearon\fR
|
Command-Line Switch: \fB-yearon\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies whether or not to display the year spinner in any of the forms
|
Specifies whether or not to display the year spinner in any of the forms
|
acceptable to \fBTcl_GetBoolean\fR. The default is true.
|
acceptable to \fBTcl_GetBoolean\fR. The default is true.
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fByearWidth\fR
|
Name: \fByearWidth\fR
|
Class: \fBWidth\fR
|
Class: \fBWidth\fR
|
Command-Line Switch: \fB-yearwidth\fR
|
Command-Line Switch: \fB-yearwidth\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the width of the year spinner in any of the forms acceptable to
|
Specifies the width of the year spinner in any of the forms acceptable to
|
\fBTcl_GetPixels\fR. The default is 3 pixels.
|
\fBTcl_GetPixels\fR. The default is 3 pixels.
|
.LP
|
.LP
|
.nf
|
.nf
|
.BE
|
.BE
|
|
|
.SH DESCRIPTION
|
.SH DESCRIPTION
|
.PP
|
.PP
|
|
|
The \fBspindate\fR command creates a set of spinners for use in date value
|
The \fBspindate\fR command creates a set of spinners for use in date value
|
entry. The set includes an month, day, and year spinner widget.
|
entry. The set includes an month, day, and year spinner widget.
|
|
|
.SH "METHODS"
|
.SH "METHODS"
|
.PP
|
.PP
|
The \fBspindate\fR command creates a new Tcl command whose
|
The \fBspindate\fR command creates a new Tcl command whose
|
name is \fIpathName\fR. This
|
name is \fIpathName\fR. This
|
command may be used to invoke various
|
command may be used to invoke various
|
operations on the widget. It has the following general form:
|
operations on the widget. It has the following general form:
|
.DS C
|
.DS C
|
\fIpathName option \fR?\fIarg arg ...\fR?
|
\fIpathName option \fR?\fIarg arg ...\fR?
|
.DE
|
.DE
|
\fIOption\fR and the \fIarg\fRs
|
\fIOption\fR and the \fIarg\fRs
|
determine the exact behavior of the command. The following
|
determine the exact behavior of the command. The following
|
commands are possible for spindate widgets:
|
commands are possible for spindate widgets:
|
|
|
.SH "WIDGET-SPECIFIC METHODS"
|
.SH "WIDGET-SPECIFIC METHODS"
|
.TP
|
.TP
|
\fIpathName \fBcget\fR \fIoption\fR
|
\fIpathName \fBcget\fR \fIoption\fR
|
Returns the current value of the configuration option given
|
Returns the current value of the configuration option given
|
by \fIoption\fR.
|
by \fIoption\fR.
|
\fIOption\fR may have any of the values accepted by the \fBspindate\fR
|
\fIOption\fR may have any of the values accepted by the \fBspindate\fR
|
command.
|
command.
|
.TP
|
.TP
|
\fIpathName\fR \fBconfigure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?
|
\fIpathName\fR \fBconfigure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?
|
Query or modify the configuration options of the widget.
|
Query or modify the configuration options of the widget.
|
If no \fIoption\fR is specified, returns a list describing all of
|
If no \fIoption\fR is specified, returns a list describing all of
|
the available options for \fIpathName\fR (see \fBTk_ConfigureInfo\fR for
|
the available options for \fIpathName\fR (see \fBTk_ConfigureInfo\fR for
|
information on the format of this list). If \fIoption\fR is specified
|
information on the format of this list). If \fIoption\fR is specified
|
with no \fIvalue\fR, then the command returns a list describing the
|
with no \fIvalue\fR, then the command returns a list describing the
|
one named option (this list will be identical to the corresponding
|
one named option (this list will be identical to the corresponding
|
sublist of the value returned if no \fIoption\fR is specified). If
|
sublist of the value returned if no \fIoption\fR is specified). If
|
one or more \fIoption\-value\fR pairs are specified, then the command
|
one or more \fIoption\-value\fR pairs are specified, then the command
|
modifies the given widget option(s) to have the given value(s); in
|
modifies the given widget option(s) to have the given value(s); in
|
this case the command returns an empty string.
|
this case the command returns an empty string.
|
\fIOption\fR may have any of the values accepted by the \fBspindate\fR
|
\fIOption\fR may have any of the values accepted by the \fBspindate\fR
|
command.
|
command.
|
.TP
|
.TP
|
\fIpathName \fBget\fR ?\fBformat\fR?
|
\fIpathName \fBget\fR ?\fBformat\fR?
|
Returns the current contents of the spindate widget in a format of
|
Returns the current contents of the spindate widget in a format of
|
string or as an integer clock value using the \fB-string\fR and \fB-clicks\fR
|
string or as an integer clock value using the \fB-string\fR and \fB-clicks\fR
|
format options respectively. The default is by string. Reference the
|
format options respectively. The default is by string. Reference the
|
clock command for more information on obtaining dates and their
|
clock command for more information on obtaining dates and their
|
formats.
|
formats.
|
.TP
|
.TP
|
\fIpathName \fBshow\fR \fIdate\fR
|
\fIpathName \fBshow\fR \fIdate\fR
|
Changes the currently displayed date to be that of the date
|
Changes the currently displayed date to be that of the date
|
argument. The date may be specified either as a string, an
|
argument. The date may be specified either as a string, an
|
integer clock value or the keyword "now". Reference the clock
|
integer clock value or the keyword "now". Reference the clock
|
command for more information on obtaining dates and their formats.
|
command for more information on obtaining dates and their formats.
|
|
|
.ta 4c
|
.ta 4c
|
.SH "COMPONENTS"
|
.SH "COMPONENTS"
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBmonth\fR
|
Name: \fBmonth\fR
|
Class: \fBSpinner\fR
|
Class: \fBSpinner\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
The month spinner component is the month spinner of the date spinner.
|
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.
|
See the Spinner widget manual entry for details on the month component item.
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBday\fR
|
Name: \fBday\fR
|
Class: \fBSpinint\fR
|
Class: \fBSpinint\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
The day spinner component is the day spinner of the date spinner.
|
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.
|
See the SpinInt widget manual entry for details on the day component item.
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fByear\fR
|
Name: \fByear\fR
|
Class: \fBSpinint\fR
|
Class: \fBSpinint\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
The year spinner component is the year spinner of the date spinner.
|
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.
|
See the SpinInt widget manual entry for details on the year component item.
|
.fi
|
.fi
|
|
|
.SH EXAMPLE
|
.SH EXAMPLE
|
.DS
|
.DS
|
spindate .sd
|
spindate .sd
|
pack .sd -padx 10 -pady 10
|
pack .sd -padx 10 -pady 10
|
.DE
|
.DE
|
.SH AUTHOR
|
.SH AUTHOR
|
Sue Yockey
|
Sue Yockey
|
.DE
|
.DE
|
Mark L. Ulferts
|
Mark L. Ulferts
|
.SH KEYWORDS
|
.SH KEYWORDS
|
spindate, spinint, spinner, entryfield, entry, widget
|
spindate, spinint, spinner, entryfield, entry, widget
|
|
|
|
|