1iwidgets::spindate  −  Create and manipulate time spinner widgets

iwidgets::spindate pathName ?options? itk::Widget <‐ iwid‐

3gets::Spindate
4

background cursor foreground relief

6See  the  "options"  manual entry for details on the standard op‐
7tions.

textBackground textFont

9See the "entryfield" manual entry for details on the above  asso‐
10ciated options.

labelFont labelMargin

12See the "labeledwidget" manual entry for details on the above as‐
13sociated options.

arrowOrient repeatDelay repeatInterval

15See the "spinner" manual entry for details on the above associat‐
16ed options.
17
18Name:           dateMargin
19Class:          Margin
20Command‐Line Switch:           ‐datemargin
21Specifies the margin space between the month, day, and year spin‐
22ners is any of the forms accpetable to  Tcl_GetPixels.   The  de‐
23fault is 1 pixel.
24Name:           dayLabel
25Class:          Text
26Command‐Line Switch:           ‐daylabel
27Specifies the text of the label for the day spinner.  The default
28is "Day".
29Name:           dayOn
30Class:          dayOn
31Command‐Line Switch:           ‐dayon
32Specifies whether or not to display the day spinner in any of the
33forms acceptable to Tcl_GetBoolean.  The default is true.
34Name:           dayWidth
35Class:          Width
36Command‐Line Switch:           ‐daywidth
37Specifies  the  width  of the day spinner in any of the forms ac‐
38ceptable to Tcl_GetPixels.  The default is 3 pixels.
39Name:           labelPos
40Class:          Position
41Command‐Line Switch:           ‐labelpos
42Specifies the position of the label along the sides of the  vari‐
43ous spinners: n, e, s, or w.  The default is w.
44Name:           monthFormat
45Class:          MonthFormat
46Command‐Line Switch:           ‐monthformat
47Specifies  the  format  of month display, integer (1‐12) or brief
48strings (Jan ‐ Dec), or full strings (January ‐ December).
49Name:           monthLabel
50Class:          Text
51Command‐Line Switch:           ‐monthlabel
52Specifies the text of the label for the month spinner.   The  de‐
53fault is "Month".
54Name:           monthOn
55Class:          monthOn
56Command‐Line Switch:           ‐monthon
57Specifies  whether  or not to display the month spinner in any of
58the forms acceptable to Tcl_GetBoolean.  The default is true.
59Name:           monthWidth
60Class:          Width
61Command‐Line Switch:           ‐monthwidth
62Specifies the width of the month spinner in any of the forms  ac‐
63ceptable to Tcl_GetPixels.  The default is 3 pixels.
64Name:           orient
65Class:          Orient
66Command‐Line Switch:           ‐orient
67Specifies  the  orientation of the month, day, and year spinners:

vertical or horizontal. The default is horizontal.

69Name:           yearDigits
70Class:          YearDigits
71Command‐Line Switch:           ‐yeardigits
72Specifies the number of digits to be displayed as the  value  for
73the  year spinner.  The valid values are 2 and 4.  The default is
742.
75Name:           yearLabel
76Class:          Text
77Command‐Line Switch:           ‐yearlabel
78Specifies the text of the label for the year  spinner.   The  de‐
79fault is "Year"
80Name:           yearOn
81Class:          yearOn
82Command‐Line Switch:           ‐yearon
83Specifies  whether  or  not to display the year spinner in any of
84the forms acceptable to Tcl_GetBoolean.  The default is true.
85Name:           yearWidth
86Class:          Width
87Command‐Line Switch:           ‐yearwidth
88Specifies the width of the year spinner in any of the  forms  ac‐
89ceptable to Tcl_GetPixels.  The default is 3 pixels.
90
91
92The iwidgets::spindate command creates a set of spinners for use in date value
93entry.  The set includes an month, day, and year spinner widget.
94
95The iwidgets::spindate command creates a new Tcl command whose
96name is pathName. This
97command may be used to invoke various
98operations on the widget. It has the following general form:

pathName option ?arg arg ...?

Option and the args

101determine the exact behavior of the command. The following
102commands are possible for spindate widgets:
103

pathName cget option

105Returns the current value of the configuration option given
106by option.

Option may have any of the values accepted by the iwidgets::spindate

108command.

pathName configure ?option? ?value option value ...?

110Query or modify the configuration options of the widget.
111If no option is specified, returns a list describing all of
112the available options for pathName (see Tk_ConfigureInfo for
113information on the format of this list).  If option is specified
114with no value, then the command returns a list describing the
115one named option (this list will be identical to the corresponding
116sublist of the value returned if no option is specified).  If
117one or more option−value pairs are specified, then the command
118modifies the given widget option(s) to have the given value(s);  in
119this case the command returns an empty string.

Option may have any of the values accepted by the iwidgets::spindate

121command.

pathName get ?format?

123Returns the current contents of the spindate widget in a format of
124string or as an integer clock value using the ‐string and ‐clicks
125format options respectively.  The default is by string.  Reference the
126clock command for more information on obtaining dates and their
127formats.

pathName show date

129Changes the currently displayed date to be that of the date
130argument.  The date may be specified either as a string, an
131integer clock value or the keyword "now".  Reference the clock
132command for more information on obtaining dates and their formats.
133
134Name:           month
135Class:          Spinner
136The  month  spinner  component  is  the month spinner of the date
137spinner.  See the Spinner widget manual entry for details on  the
138month component item.
139Name:           day
140Class:          Spinint
141The day spinner component is the day spinner of the date spinner.
142See the SpinInt widget manual entry for details on the day compo‐
143nent item.
144Name:           year
145Class:          Spinint
146The  year spinner component is the year spinner of the date spin‐
147ner.  See the SpinInt widget manual entry fordetails on the  year
148component item.
149
150package  require  Iwidgets  4.0  iwidgets::spindate  .sd pack .sd
151‐padx 10 ‐pady 10 Sue Yockey Mark L. Ulferts  spindate,  spinint,
152spinner, entryfield, entry, widget
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
Impressum