---
name: "messageBox"
section: "n"
platform: "macos"
package: "tcl"
version: "152"
release: "macOS 26.5"
platforms: ["macos"]
url: "https://new.carta.tech/messageBox/n"
---

# messageBox(n)

pops up a message window and waits for user response.

## NAME

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

## SYNOPSIS

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

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

- **-default** *name*

  *Name* gives the symbolic name of the default button for this message window ( 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*

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

- **-icon** *iconImage*

  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*

  Specifies the message to display in this message box.

- **-parent** *window*

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

- **-title** *titleString*

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

- **-type** *predefinedType*

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

  - **abortretryignore**

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

  - **ok**

    Displays one button whose symbolic name is **ok**.

  - **okcancel**

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

  - **retrycancel**

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

  - **yesno**

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

  - **yesnocancel**

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

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

message box