---
name: "timefield"
section: "3iwidgets"
platform: "linux"
package: "iwidgets3.1-doc"
version: "3.1.0-9"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/timefield"
---

# timefield(3iwidgets)

Create and manipulate a time field widget

```

```

## NAME

timefield - Create and manipulate a time field widget

## SYNOPSIS

**timefield** *pathName* ?*options*?

## INHERITANCE

itk::Widget \<- LabeledWidget \<- timefield

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

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 *arg*s 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