WOLFRAM

Wolfram Language & System Documentation Center

ChoiceDialog[expr]

puts up a standard choice dialog that displays expr together with OK and Cancel buttons, and returns True if OK is clicked and False if Cancel is clicked.

ChoiceDialog[expr,{lbl1val1,lbl2val2,…}]

includes buttons with labels lbli, and returns the corresponding vali for the button clicked.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
See Also
Tech Notes
Related Guides
History
Cite this Page

ChoiceDialog

ChoiceDialog[expr]

puts up a standard choice dialog that displays expr together with OK and Cancel buttons, and returns True if OK is clicked and False if Cancel is clicked.

ChoiceDialog[expr,{lbl1val1,lbl2val2,…}]

includes buttons with labels lbli, and returns the corresponding vali for the button clicked.

Details and Options

  • ChoiceDialog places buttons automatically, outside the area used to display expr.
  • Any expressions, including both text and graphics, can be used for expr and the lbli.
  • In the window generated by ChoiceDialog[expr], pressing TemplateBox[{return}, Key0, BaseStyle -> {Notes, FontWeight -> Plain, FontFamily -> Source Sans Pro}] is taken to be equivalent to clicking the OK button, while pressing or closing the window is taken to be equivalent to clicking the Cancel button.
  • In ChoiceDialog[expr,{lbl1->val1,…}], pressing TemplateBox[{return}, Key0, BaseStyle -> {Notes, FontWeight -> Plain, FontFamily -> Source Sans Pro}] returns val1, while pressing or closing the window returns val2.
  • ChoiceDialog allows the sequence of buttons to linewrap by default if needed, and supports the same Appearance option settings as SetterBar to specify other button configurations.
  • ChoiceDialog by default puts up a notebook with a typical choice dialog appearance. The option settings include WindowFloating->False, WindowSize->All, and WindowTitle->None.
  • ChoiceDialog by default puts up a dialog in the middle of the main display screen. Explicit settings for WindowMargins override this.
  • If the Wolfram System is run without a notebook front end, ChoiceDialog gives choices in a textual form.

Examples

open all close all

Basic Examples  (2)

Create a choice dialog:

Create a multiple-choice dialog:

Scope  (1)

In a standalone kernel, choices are listed in parentheses with the default choice in square brackets:

In[1]:= ChoiceDialog["Are you sure you want to do that?"]
Are you sure you want to do that? (OK, Cancel) [OK]: 

Out[1]= True
Wolfram Research (2007), ChoiceDialog, Wolfram Language function, https://reference.wolfram.com/language/ref/ChoiceDialog.html (updated 2020).

Text

Wolfram Research (2007), ChoiceDialog, Wolfram Language function, https://reference.wolfram.com/language/ref/ChoiceDialog.html (updated 2020).

CMS

Wolfram Language. 2007. "ChoiceDialog." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2020. https://reference.wolfram.com/language/ref/ChoiceDialog.html.

APA

Wolfram Language. (2007). ChoiceDialog. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ChoiceDialog.html

BibTeX

@misc{reference.wolfram_2025_choicedialog, author="Wolfram Research", title="{ChoiceDialog}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/ChoiceDialog.html}", note=[Accessed: 30-October-2025]}

BibLaTeX

@online{reference.wolfram_2025_choicedialog, organization={Wolfram Research}, title={ChoiceDialog}, year={2020}, url={https://reference.wolfram.com/language/ref/ChoiceDialog.html}, note=[Accessed: 30-October-2025]}