| 1 | \section{wxDialog overview}\label{wxdialogoverview} |
| 2 | |
| 3 | Classes: \helpref{wxDialog}{wxdialog} |
| 4 | |
| 5 | A dialog box is similar to a panel, in that it is a window which can |
| 6 | be used for placing controls, with the following exceptions: |
| 7 | |
| 8 | \begin{enumerate} |
| 9 | \item A surrounding frame is implicitly created. |
| 10 | \item Extra functionality is automatically given to the dialog box, |
| 11 | such as tabbing between items (currently Windows only). |
| 12 | \item If the dialog box is {\it modal}, the calling program is blocked |
| 13 | until the dialog box is dismissed. |
| 14 | \end{enumerate} |
| 15 | |
| 16 | Under Windows 3, modal dialogs have to be emulated using |
| 17 | modeless dialogs and a message loop. This is because Windows 3 expects |
| 18 | the contents of a modal dialog to be loaded from a resource file or |
| 19 | created on receipt of a dialog initialization message. This is too |
| 20 | restrictive for wxWindows, where any window may be created and displayed |
| 21 | before its contents are created. |
| 22 | |
| 23 | For a set of dialog convenience functions, including file selection, see |
| 24 | \rtfsp\helpref{Dialog functions}{dialogfunctions}. |
| 25 | |
| 26 | See also \helpref{wxPanel}{wxpanel} and \helpref{wxWindow}{wxwindow} for inherited |
| 27 | member functions. Validation of data in controls is covered |
| 28 | in \helpref{Validator overview}{validatoroverview}. |
| 29 | |
| 30 | |
| 31 | |