Built-in Mathematica Symbol

DialogReturn

DialogReturn[expr]
closes a dialog window, returning the expression expr from the dialog.

DialogReturn[]
closes a dialog window, returning Null.

If DialogReturn[expr] is used inside a dialog put up by DialogInput, then expr will be the value returned by DialogInput.

If DialogReturn[expr] is used inside a dialog created by CreateDialog, expr will be evaluated and then discarded.

Put up a dialog window that returns 123 when the button is clicked:

Put up a dialog window that returns 123 when the button is clicked:

Out[2]//FullForm=

Create a dialog input window that returns a user input:

Enter a string in the field and click Proceed to return the string:

This input puts up a dialog window and does not wait for a return value:

Typing in the dialog window dynamically changes name but has no immediate effect on res:

The kernel evaluates other inputs while the dialog window is open:

After the Proceed button is clicked, the effect of DialogReturn[res=name] can be seen:

Return different values, depending which button is clicked:

This uses DialogReturn[] to return from the dialog notebook:

DefaultButton[] can be used instead of an explicit DialogReturn[]:

CancelButton[] implicitly uses DialogReturn[$Canceled]: