[wxWidgets.git] / docs / latex / wx / tdialog.tex

\section{wxDialog overview}\label{wxdialogoverview}

Classes: \helpref{wxDialog}{wxdialog}

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

\begin{enumerate}
\item A surrounding frame is implicitly created.
\item Extra functionality is automatically given to the dialog box,
  such as tabbing between items (currently Windows only).
\item If the dialog box is {\it modal}, the calling program is blocked
  until the dialog box is dismissed.
\end{enumerate}

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.

For a set of dialog convenience functions, including file selection, see
\rtfsp\helpref{Dialog functions}{dialogfunctions}.

See also \helpref{wxPanel}{wxpanel} and \helpref{wxWindow}{wxwindow} for inherited
member functions. Validation of data in controls is covered
in \helpref{Validator overview}{validatoroverview}.
Commit	Line	Data
a660d684 KB	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