SEARCH MATHEMATICA 8 DOCUMENTATION

THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.

Mathematica > Dynamic Interactivity > Custom Interface Construction > Dialog Boxes >

Built-in Mathematica Symbol

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, {lbl₁->val₁, lbl₂->val₂, ...}]
includes buttons with labels lbl_i, and returns the corresponding val_i for the button clicked.

MORE INFORMATION

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 lbl_i.

In the window generated by ChoiceDialog[expr], pressing Enter is taken to be equivalent to clicking the OK button, while pressing Esc or closing the window is taken to be equivalent to clicking the Cancel button.

In ChoiceDialog[expr, {lbl₁->val₁, ...}], pressing Enter returns val₁, while pressing Esc or closing the window returns val₂.

ChoiceDialog by default puts up a notebook with a typical choice dialog appearance. The option settings include WindowFloating->False, WindowSize->All and WindowTitle->None.