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

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

3gets::Spintime
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:           labelPos
19Class:          Position
20Command‐Line Switch:           ‐labelpos
21Specifies  the position of the label along the sides of the vari‐
22ous spinners: n, e, s, or w.  The default is w.
23Name:           hourLabel
24Class:          Text
25Command‐Line Switch:           ‐hourlabel
26Specifies the text of the label for the hour  spinner.   The  de‐
27fault is "Hour".
28Name:           hourOn
29Class:          hourOn
30Command‐Line Switch:           ‐houron
31Specifies  whether  or  not to display the hour spinner in any of
32the forms acceptable to Tcl_GetBoolean.  The default is true.
33Name:           hourWidth
34Class:          Width
35Command‐Line Switch:           ‐hourwidth
36Specifies the width of the hour spinner in any of the  forms  ac‐
37ceptable to Tcl_GetPixels.  The default is 3 pixels.
38Name:           militaryOn
39Class:          militaryOn
40Command‐Line Switch:           ‐militaryon
41Specifies  use  of a 24 hour clock for hour display in any of the
42forms acceptable to Tcl_GetBoolean.  The default is true.
43Name:           minuteLabel
44Class:          Text
45Command‐Line Switch:           ‐minutelabel
46Specifies the text of the label for the minute spinner.  The  de‐
47fault is "Minute".
48Name:           minuteOn
49Class:          minuteOn
50Command‐Line Switch:           ‐minuteon
51Specifies  whether or not to display the minute spinner in any of
52the forms acceptable to Tcl_GetBoolean.  The default is true.
53Name:           minuteWidth
54Class:          Width
55Command‐Line Switch:           ‐minutewidth
56Specifies the width of the minute spinner in any of the forms ac‐
57ceptable to Tcl_GetPixels.  The default is 3 pixels.
58Name:           orient
59Class:          Orient
60Command‐Line Switch:           ‐orient
61Specifies  the  orientation of the hour, minute, and second spin‐
62ners: vertical or horizontal.  The default is horizontal.
63Name:           secondLabel
64Class:          Text
65Command‐Line Switch:           ‐secondlabel
66Specifies the text of the label for the second spinner.  The  de‐
67fault is "Second"
68Name:           secondOn
69Class:          secondOn
70Command‐Line Switch:           ‐secondon
71Specifies  whether or not to display the second spinner in any of
72the forms acceptable to Tcl_GetBoolean.  The default is true.
73Name:           secondWidth
74Class:          Width
75Command‐Line Switch:           ‐secondwidth
76Specifies the width of the second spinner in any of the forms ac‐
77ceptable to Tcl_GetPixels.  The default is 3 pixels.
78Name:           timeMargin
79Class:          Margin
80Command‐Line Switch:           ‐timemargin
81Specifies  the  margin space between the hour, minute, and second
82spinners is any of the forms accpetable  to  Tcl_GetPixels.   The
83default is 1 pixel.
84
85
86The iwidgets::spintime command creates a set of spinners for use in time value
87entry.  The set includes an hour, minute, and second spinner widget.
88
89The iwidgets::spintime command creates a new Tcl command whose
90name is pathName. This
91command may be used to invoke various
92operations on the widget. It has the following general form:

pathName option ?arg arg ...?

Option and the args

95determine the exact behavior of the command. The following
96commands are possible for spintime widgets:
97

pathName cget option

99Returns the current value of the configuration option given
100by option.

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

102command.

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

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

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

115command.

pathName get ?format?

117Returns the current contents of the spintime widget in a format of
118string or as an integer clock value using the ‐string and ‐clicks
119format options respectively.  The default is by string.  Reference the
120clock command for more information on obtaining time and its
121formats.

pathName show time

123Changes the currently displayed time to be that of the time
124argument.  The time may be specified either as a string, an
125integer clock value or the keyword "now".  Reference the clock
126command for more information on obtaining times and its format.
127
128Name:           hour
129Class:          Spinint
130The  hour component is the hour spinner of the time spinner.  See
131the SpinInt widget manual entry for details on the hour component
132item.
133Name:           minute
134Class:          Spinint
135The  minute  component is the minute spinner of the time spinner.
136See the SpinInt widget manual entry for  details  on  the  minute
137component item.
138Name:           second
139Class:          Spinint
140The  second  component is the second spinner of the time spinner.
141See the SpinInt widget manual entry for  details  on  the  second
142component item.
143
144package  require  Iwidgets  4.0  iwidgets::spintime  .st pack .st
145‐padx 10 ‐pady 10 Sue Yockey Mark L. Ulferts  spintime,  spinint,
146spinner, entryfield, entry, widget
147
148
149
150
151
152
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