NAME
timeentry - Create and manipulate a timeentry widget
SYNOPSIS
timeentry pathName ?options?
INHERITANCE
itk::Widget <- LabeledWidget <- Timefield <- Timeentry
STANDARD OPTIONS
background borderWidth cursor exportSelection
foreground highlightColor highlightThicknessinsertBackground
justify relief
See the "options" manual entry for details on the standard
options.
INHERITED OPTIONS
disabledForeground labelBitmap labelFontlabelImage
labelMargin labelPos labelText labelVariable
state
See the "labeledwidget" class manual entry for details on
these inherited options.
command format seconds textBackground
textFont
See the "timefield" class manual entry for details on
these inherited options.
ASSOCIATED OPTIONS
hourRadius hourColor minuteRadius minuteColor
pivotRadius pivotColor secondRadius secondColor
clockColor clockStipple tickColor watchHeight
watchWidth
See the "watch" manual entry for details on the associated
options.
WIDGET-SPECIFIC OPTIONS
Name: closeText
Class: Text
Command-Line Switch: -closetext
Specifies the text to be displayed on the close
button of the watch popup. The default is Close.
Name: grab
Class: Grab
Command-Line Switch: -grab
obtained before bringing up the popup watch. The
default is global. For more information concerning
grab levels, consult the documentation for Tk's
grab command.
Name: icon
Class: Icon
Command-Line Switch: -icon
Specifies the watch icon image to be used in the
timeentry. This image must have been created pre
viously with the image create command. Should one
not be provided, then one will be generated, pixmap
if possible, bitmap otherwise.
Name: state
Class: State
Command-Line Switch: -state
Specifies the state of the widget which may be dis
abled or normal. A disabled state prevents selec
tion of the timefield or time icon button.
_________________________________________________________________
DESCRIPTION
The timeentry command creates a time entry field with a
popup watch by combining the timefield and watch widgets
together. This allows a user to enter the time via the
keyboard or by using the mouse and selecting the watch
icon which brings up a popup watch.
METHODS
The timeentry 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 timeen
try widgets:
INHERITED METHODS
get isvalid show
See the "timefield" manual entry for details on the asso
ciated 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 timeentry 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 path
Name (see Tk_ConfigureInfo for information on the
format of this list). If option is specified with
no value, then the command returns a list describ
ing the one named option (this list will be identi
cal 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 timeentry command.
COMPONENTS
Name: label
Class: Label
The label component provides a label component to
used to identify the time. See the "label" widget
manual entry for details on the label component
item.
Name: iconbutton
Class: Label
The iconbutton component provides a labelbutton
component to act as a lightweight button displaying
the watch icon. Upon pressing the labelbutton, the
watch appears. See the "label" widget manual entry
for details on the labelbutton component item.
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
timeentry .te
pack .te
Mark L. Ulferts
KEYWORDS
timeentry, widget
Man(1) output converted with
man2html