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

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 Wolfram System windows can be used until the dialog has been closed. If there is no mechanism for closing the dialog, the Wolfram System 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.
Introduced in 2007
Translate this page: