Executing common dialog boxes

After you have constructed the common dialog box object, you either execute it (for a modal dialog box) or create it (for a modeless dialog box).

The following table lists whether each type of common dialog box must be modal or modeless.

Type	Modal or modeless	Run by calling
Color	Modal	Execute
Font	Modal	Execute
File open	Modal	Execute
File save	Modal	Execute
Find	Modeless	Create
Find/replace	Modeless	Create
Printer	Modal	Execute

You must check Execute's return value to see whether the user chose OK or Cancel, or to determine if an error occurred. For example,

TChooseColorDialog::TData colors;
TChooseColorDialog colorDlg(this, colors);
 
if (colorDlg.Execute() == IDOK)
 // OK: data.Color == the color the user
chose
 // Some code here
else if (data.Error)
 // error occurred!
 // Some code here
 MessageBox("Error in color dialog box!", GetApplication()->Name, MB_OK | MB_ICONSTOP);

See Also

• Constructing common dialog boxes
• Executing common dialog boxes