wxDialogBox: wxPanel

A dialog box is similar to a panel, in that it is a window which can be used for placing panel items, with the following exceptions:

  1. A surrounding frame is implicitly created.
  2. Extra functionality is automatically given to the dialog box, such as tabbing between items (currently Windows only).
  3. If the dialog box is modal, the calling program is blocked until the dialog box is dismissed.

Under XView, some panel items may display incorrectly in a modal dialog.

Note that under Windows 3, modal dialogs have to be emulated using modeless dialogs and a message loop. This is because Windows 3 expects the contents of a modal dialog to be loaded from a resource file or created on receipt of a dialog initialization message. This is too restrictive for wxWindows, where any window may be created and displayed before its contents are created.

It would be easy to add a facility for loading Windows 3 dialog resources instead of building them programmatically, but of course this method is very non-portable. See the discussion about dialogs in the user manual.

For a set of dialog convenience functions, including file selection, see Dialog functions.

See also wxPanel and wxWindow for inherited member functions.

wxDialogBox::wxDialogBox

wxDialogBox::~wxDialogBox

wxDialog::Centre

wxDialogBox::Create

wxDialogBox::GetTitle

wxDialogBox::Iconize

wxDialogBox::Iconized

wxDialogBox::SetTitle

wxDialogBox::Show