tk\_messageBox(n) Tk Built-In Commands tk\_messageBox(n)

```

```

# [NAME](#NAME)

tk\_messageBox - pops up a message window and waits for user response.

# [SYNOPSIS](#SYNOPSIS)

**tk\_messageBox** ?*option value ...*?

```

```

# [DESCRIPTION](#DESCRIPTION)

This procedure creates and displays a message window with an application-specified message, an icon and a set of buttons. Each of the buttons in the message window is identified by a unique symbolic name (see the **-type** options). After the message window is popped up, **tk\_messageBox** waits for the user to select one of the buttons. Then it returns the symbolic name of the selected button.

The following option-value pairs are supported:

[**-command string**](#command)

Specifies the prefix of a Tcl command to invoke when the user closes the dialog. The actual command consists of *string* followed by a space and the name of the button clicked by the user to close the dialog. This is only available on macOS.

[**-default name**](#default)

*Name* gives the symbolic name of the default button for this message window ( “ok”, “cancel”, and so on). See **-type** for a list of the symbolic names. If this option is not specified, the first button in the dialog will be made the default.

[**-detail string**](#detail)

Specifies an auxiliary message to the main message given by the **-message** option. The message detail will be presented beneath the main message and, where supported by the OS, in a less emphasized font than the main message.

[**-icon iconImage**](#icon)

Specifies an icon to display. *IconImage* must be one of the following: **error**, **info**, **question** or **warning**. If this option is not specified, then the info icon will be displayed.

[**-message string**](#message)

Specifies the message to display in this message box. The default value is an empty string.

[**-parent window**](#parent)

Makes *window* the logical parent of the message box. The message box is displayed on top of its parent window.

[**-title titleString**](#title)

Specifies a string to display as the title of the message box. The default value is an empty string.

[**-type predefinedType**](#type)

Arranges for a predefined set of buttons to be displayed. The following values are possible for *predefinedType*:

[**abortretryignore**](#abortretryignore)

Displays three buttons whose symbolic names are **abort**, **retry** and **ignore**.

[**ok**](#ok)

Displays one button whose symbolic name is **ok**. This is the default.

[**okcancel**](#okcancel)

Displays two buttons whose symbolic names are **ok** and **cancel**.

[**retrycancel**](#retrycancel)

Displays two buttons whose symbolic names are **retry** and **cancel**.

[**yesno**](#yesno)

Displays two buttons whose symbolic names are **yes** and **no**.

[**yesnocancel**](#yesnocancel)

Displays three buttons whose symbolic names are **yes**, **no** and **cancel**.

# [EXAMPLE](#EXAMPLE)

```
set answer [tk_messageBox -message "Really quit?" \


        -icon question -type yesno \


        -detail "Select \"Yes\" to make the application exit"]
switch -- $answer {


    yes exit


    no {tk_messageBox -message "I know you like this application!" \


            -type ok}
}
```

# [KEYWORDS](#KEYWORDS)

message box

4.2 Tk

---

Document: tk_messageBox(n) from tk 9.0.4-r2 (Chainguard OS)
Source: https://downloads.sourceforge.net/sourceforge/tcl/tk9.0.4-src.tar.gz