---
name: "iwidgets_timeentry"
section: "3iwidget"
platform: "linux"
package: "iwidgets4-doc"
version: "4.1.1-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/iwidgets_timeentry"
---

# iwidgets\_timeentry(3iwidget)

Create and manipulate a timeentry widget

```

```

## NAME

iwidgets::timeentry - Create and manipulate a timeentry widget

## SYNOPSIS

**iwidgets::timeentry** *pathName* ?*options*?

## INHERITANCE

itk::Widget \<- iwidgets::LabeledWidget \<- iwidgets::Timefield \<- iwidgets::Timeentry

## STANDARD OPTIONS

```
background  borderWidth     cursor              exportSelection
foreground  highlightColor  highlightThickness  insertBackground
justify     relief
```

See the "options" manual entry for details on the standard options.

## INHERITED OPTIONS

```
disabledForeground	labelBitmap	labelFont	labelImage
labelMargin	labelPos	labelText	labelVariable
state sticky
```

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
```

-

  Specifies the grab level, **local** or **global**, to be 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 previously 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 **disabled** or **normal**.  A disabled state prevents selection of the timefield or time icon button.

```

```

## DESCRIPTION

The **iwidgets::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 **iwidgets::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 *arg*s determine the exact behavior of the command.  The following commands are possible for timeentry widgets:

## INHERITED METHODS

```
get	isvalid	show
```

See the "timefield" manual entry for details on the associated methods.

## 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 **iwidgets::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 *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 **iwidgets::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

```

 package require Iwidgets 4.0
 iwidgets::timeentry .te
 pack .te
```

## AUTHOR

Mark L. Ulferts

## KEYWORDS

timeentry, widget