1iwidgets::timefield  −  Create and manipulate a time field widget

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

3gets::LabeledWidget <‐ iwidgets::Timefield

background borderWidth cursor exportSelection

foreground highlightColor highlightThickness insertBackground

justify relief

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

disabledForeground labelBitmap labelFontlabelImage

labelMargin labelPos labelText labelVariable

state sticky

12See the "labeledwidget" class manual entry for details on the in‐
13herited options.
14Name:           childSitePos
15Class:          Position
16Command‐Line Switch:           ‐childsitepos
17Specifies the position of the child site in the time field: n, s,

e, or w. The default is e.

19Name:           command
20Class:          Command
21Command‐Line Switch:           ‐command
22Specifies a Tcl command to be executed upon detection of a Return
23key press event.
24Name:           gmt
25Class:          Gmt
26Command‐Line Switch:           ‐gmt
27Determines  whether  the time is calculated relative to Greenwich
28Mean Time. Accepts a boolean value. The default is no.
29Name:           state     Class:          State      Command‐Line
30Switch:           ‐state
31Specifies  one  of  two  states for the timefield: normal or dis‐

abled. If the timefield is disabled then input is not accepted.

33The default is normal.
34Name:           textBackground
35Class:          Background
36Command‐Line Switch:           ‐textbackground
37Background  color  for inside textual portion of the entry field.
38The value may be given in any of the forms acceptable to  Tk_Get‐

Color.

40Name:           textFont
41Class:          Font
42Command‐Line Switch:           ‐textfont
43Name  of font to use for display of text in timefield.  The value
44may be given in any of the forms acceptable to Tk_GetFont.
45
46The iwidgets::timefield command creates an  enhanced  text  entry
47widget  for  the  purpose  of  time entry with various degrees of
48built‐in intelligence.
49
50The iwidgets::timefield command creates a new Tcl  command  whose
51name is pathName.  This command may be used to invoke various op‐
52erations on the widget.  It has the following general form: path‐

Name option ?arg arg ...? Option and the args determine the ex‐

54act behavior of the command.  The following commands are possible
55for  timefield  widgets: pathName cget option Returns the current
56value of the configuration option given by  option.   Option  may
57have  any  of the values accepted by the iwidgets::timefield com‐
58mand.  pathName  configure  ?option?  ?value  option  value  ...?
59Query  or  modify the configuration options of the widget.  If no

option is specified, returns a list describing all of the avail‐

61able  options  for pathName (see Tk_ConfigureInfo for information
62on the format of this list).  If option is specified with no val‐

ue, then the command returns a list describing the one named op‐

64tion (this list will be identical to the corresponding sublist of
65the  value  returned  if no option is specified).  If one or more

option−value pairs are specified, then the command modifies the

67given  widget option(s) to have the given value(s);  in this case
68the command returns an empty string.  Option may have any of  the
69values accepted by the iwidgets::timefield command.  pathName get
70?format?  Returns the current contents of the timefield in a for‐
71mat  of string or as an integer clock value using the ‐string and

‐clicks format options respectively. The default is by string.

73Reference  the  clock  command  for more information on obtaining
74times and their formats.  pathName isvalid Returns a boolean  in‐
75dication  of  the validity of the currently displayed time value.
76For example, 12:59:59  is  valid  whereas  25:59:59  is  invalid.

pathName show time Changes the currently displayed time to be

78that of the time argument.  The time may be specified either as a
79string,  an  integer  clock  value  or the keyword "now" (the de‐
80fault).  Reference the clock command for more information on  ob‐
81taining times and their formats.
82
83Name:           time
84Class:          Entry
85The  time  component  provides the entry field for time input and
86display.  See the "entry" widget manual entry for details on  the
87time component item.
88
89 package require Iwidgets 4.0
90 proc returnCmd {} {
91   puts [.tf get]
92 }
93
94 iwidgets::timefield .tf ‐command returnCmd
95 pack  .tf  ‐fill  x ‐expand yes ‐padx 10 ‐pady 10 John A. Tucker
96Mark L. Ulferts timefield, widget
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
Impressum