docs/latex/wx/tdialog.tex

   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 wxWidgets, 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