creates a dialog notebook containing expr and opens it in the front end.

CreateDialog[expr, obj]
replaces the notebook represented by the notebook object obj with the one obtained from expr.

Details and OptionsDetails and Options

  • CreateDialog by default creates a notebook with options set so as to be suitable for the appearance and behavior of a typical dialog box. The option settings include Deployed->True, ShowCellBracket->False, WindowFloating->False and WindowSize->All.
  • Dialog notebooks created by CreateDialog are by default opened in the middle of the main display screen. Explicit settings for WindowMargins override this.
  • CreateDialog[expr] by default puts expr into a single output cell.
  • If expr is a complete notebook expression, CreateDialog[expr] creates an open notebook corresponding to this expression.
  • If expr is a cell or list of cells, CreateDialog[expr] creates a notebook consisting of this cell or cells.
  • CreateDialog can take any notebook option.
  • If no explicit setting is given for WindowTitle, no name will be displayed for a dialog.
  • The additional option Modal specifies whether the dialog created by CreateDialog should be modal.
  • With the default setting Modal->False, other windows can be used even when the dialog is open. With Modal->True, no other Mathematica windows can be used until the dialog has been closed. If there is no mechanism for closing the dialog, Mathematica will effectively freeze.
  • If DialogReturn is executed, for example as a result of clicking a button, within the window created by CreateDialog, then the window will be closed.
  • In dialogs created with CreateDialog, pressing Enter is effectively equivalent to clicking the DefaultButton, and Esc to clicking the CancelButton.
  • If the dialog contains no DefaultButton or CancelButton, pressing Enter or Esc will close the dialog without taking any other action.
  • CreateDialog returns a NotebookObject corresponding to the notebook it creates.
  • CreateDialog[expr, obj] overwrites whatever data was contained in the notebook represented by the notebook object obj.

ExamplesExamplesopen allclose all

Basic Examples (2)Basic Examples (2)

Make a dialog notebook:

Make a dialog notebook that accepts input text:

Type something in the input field:

Click OK to assign the input to :

Click for copyable input
New in 6
New to Mathematica? Find your learning path »
Have a question? Ask support »