---
name: "dialog"
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/dialog/3iwidgets"
---

# dialog(3iwidgets)

Create and manipulate a dialog widget

```

```

## NAME

dialog - Create and manipulate a dialog widget

## SYNOPSIS

**dialog** *pathName* ?*options*?

## INHERITANCE

itk::Toplevel \<- Shell \<- Dialogshell \<- Dialog

## STANDARD OPTIONS

```
background	cursor	foreground
```

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

## INHERITED OPTIONS

```
buttonBoxPadX	buttonBoxPadY 	buttonBoxPos	padX
padY	separator	thickness
```

See the "dialogshell" manual entry for details on the above inherited options.

```
height	master	modality	width
```

See the "shell" manual entry for details on the above inherited options.

```
title
```

See the "Toplevel" manual entry for details on the above inherited options.

```

```

## DESCRIPTION

The **dialog** command creates a dialog box providing standard buttons and a child site for use in derived classes.  The buttons include ok, apply, cancel, and help.  Methods and Options exist to  configure the buttons and their containing box.

## METHODS

The **dialog** 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 dialog widgets:

## INHERITED METHODS

```
add	buttonconfigure	default	hide
index	insert	invoke	show
```

See the "buttonbox" manual entry for details on the above inherited methods.

```
childsite
```

See the "dialogshell" manual entry for details on the above inherited methods.

```
activate	center	deactivate
```

See the "shell" manual entry for details on the above inherited 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 **dialog** 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 **dialog** command.

## EXAMPLE

```

 dialog .d -modality global
 .d buttonconfigure OK -command {puts OK; .d deactivate 1}
 .d buttonconfigure Apply -command {puts Apply}
 .d buttonconfigure Cancel -command {puts Cancel; .d deactivate 0}
 .d buttonconfigure Help -command {puts Help}
 listbox [.d childsite].lb -relief sunken
 pack [.d childsite].lb -expand yes -fill both
 if {[.d activate]} {
     puts "Exit via OK button"
 } else {
     puts "Exit via Cancel button"
 }
```

## AUTHOR

Mark L. Ulferts

Bret A. Schuhmacher

## KEYWORDS

dialog, dialogshell, shell, widget