timefield - Create and manipulate a time field widget
SYNOPSIS
timefield pathName ?options?
INHERITANCE
itk::Widget <- LabeledWidget <- timefield
STANDARD OPTIONS
| background foreground
 justify
 
 | borderWidth highlightColor
 relief
 
 | cursor highlightThickness
 
 | exportSelection insertBackground
 
 | 
See the  "options"  manual entry for details on the standard options.
INHERITED OPTIONS
| disabledForeground labelMargin
 state
 
 | labelBitmap labelPos
 
 | labelFont labelText
 
 | labelImage labelVariable
 
 | 
See the  "labeledwidget"  class manual entry for details on the 
inherited options.
WIDGET-SPECIFIC OPTIONS
Name:                   childSitePos
Class:                  Position
Command-Line Switch:	-childsitepos
Specifies the position of the child site in the time field: n, 
s, e, or w.  The default is e.
Name:                   command
Class:                  Command
Command-Line Switch:	-command
Specifies a Tcl command to be executed upon detection of a Return key 
press event.
Name:                   state
Class:                  State
Command-Line Switch:	-state
Specifies one of two states for the timefield: normal or disabled.
If the timefield is disabled then input is not accepted.  The default is
normal.
Name:                   textBackground
Class:                  Background
Command-Line Switch:	-textbackground
Background color for inside textual portion of the entry field.  The value
may be given in any of the forms acceptable to Tk_GetColor.
Name:                   textFont
Class:                  Font
Command-Line Switch:	-textfont
Name of font to use for display of text in timefield.  The value
may be given in any of the forms acceptable to Tk_GetFont.
DESCRIPTION
The timefield command creates an enhanced text entry widget for
the purpose of time entry with various degrees of built-in intelligence.
METHODS
The timefield command creates a new Tcl command whose
name is pathName.  This
command may be used to invoke various
operations on the widget.  It has the following general form:
pathName option ?arg arg ...?
Option and the args
determine the exact behavior of the command.  The following
commands are possible for timefield widgets:
WIDGET-SPECIFIC METHODS
-  pathName cget option
-  Returns the current value of the configuration option given
by option.
Option may have any of the values accepted by the timefield
command.
-  pathName configure ?option? ?value option value ...?
-  Query or modify the configuration options of the widget.
If no option is specified, returns a list describing all of
the available options for pathName (see Tk_ConfigureInfo for
information on the format of this list).  If option is specified
with no value, then the command returns a list describing the
one named option (this list will be identical to the corresponding
sublist of the value returned if no option is specified).  If
one or more option-value pairs are specified, then the command
modifies the given widget option(s) to have the given value(s);  in
this case the command returns an empty string.
Option may have any of the values accepted by the timefield
command.
-  pathName get ?format?
-  Returns the current contents of the timefield in a format of 
string or as an integer clock value using the -string and -clicks
format options respectively.  The default is by string.  Reference the 
clock command for more information on obtaining times and their 
formats.
-  pathName isvalid
-  Returns a boolean indication of the validity of the currently
displayed time value.  For example, 12:59:59 is valid whereas
25:59:59 is invalid.
-  pathName show time
-  Changes the currently displayed time to be that of the time 
argument.  The time may be specified either as a string, an
integer clock value or the keyword "now" (the default). 
Reference the clock command for more information on obtaining
times and their formats.
COMPONENTS
Name:                   time
Class:                  Entry
The time component provides the entry field for time input and display.
See the  "entry"  widget manual entry for details on the time component item.
EXAMPLE
 proc returnCmd {} {
   puts [.tf get]
 }
 timefield .tf -command returnCmd
 pack .tf -fill x -expand yes -padx 10 -pady 10
AUTHOR
John A. Tucker
Mark L. Ulferts
KEYWORDS
timefield, widget