]> git.saurik.com Git - wxWidgets.git/blame - docs/latex/wx/splash.tex
added CreateSeparatedButtonSizer(), changed signature and semantics of CreateButtonSi...
[wxWidgets.git] / docs / latex / wx / splash.tex
CommitLineData
e3c10211
JS
1\section{\class{wxSplashScreen}}\label{wxsplashscreen}
2
3wxSplashScreen shows a window with a thin border, displaying a bitmap describing your
4application. Show it in application initialisation, and then either explicitly destroy
5it or let it time-out.
6
7Example usage:
8
9\begin{verbatim}
10 wxBitmap bitmap;
11 if (bitmap.LoadFile("splash16.png", wxBITMAP_TYPE_PNG))
12 {
13 wxSplashScreen* splash = new wxSplashScreen(bitmap,
14 wxSPLASH_CENTRE_ON_SCREEN|wxSPLASH_TIMEOUT,
15 6000, NULL, -1, wxDefaultPosition, wxDefaultSize,
16 wxSIMPLE_BORDER|wxSTAY_ON_TOP);
17 }
18 wxYield();
19\end{verbatim}
479101ca 20
e3c10211
JS
21\wxheading{Derived from}
22
23\helpref{wxFrame}{wxframe}\\
24\helpref{wxWindow}{wxwindow}\\
25\helpref{wxEvtHandler}{wxevthandler}\\
26\helpref{wxObject}{wxobject}
27
28\wxheading{Include files}
29
30<wx/splash.h>
31
32\latexignore{\rtfignore{\wxheading{Members}}}
33
34\membersection{wxSplashScreen::wxSplashScreen}\label{wxsplashscreenwxsplashscreen}
35
479101ca 36\func{}{wxSplashScreen}{\param{const wxBitmap\& }{bitmap}, \param{long }{splashStyle}, \param{int }{milliseconds}, \param{wxWindow* }{parent}, \param{wxWindowID }{id}, \param{const wxPoint\& }{pos = wxDefaultPosition}, \param{const wxSize\& }{size = wxDefaultSize}, \param{long }{style = wxSIMPLE\_BORDER|wxFRAME\_NO\_TASKBAR|wxSTAY\_ON\_TOP}}
e3c10211
JS
37
38Construct the splash screen passing a bitmap, a style, a timeout, a window id, optional position
39and size, and a window style.
40
41{\it splashStyle} is a bitlist of some of the following:
42
43\begin{itemize}\itemsep=0pt
44\item wxSPLASH\_CENTRE\_ON\_PARENT
45\item wxSPLASH\_CENTRE\_ON\_SCREEN
46\item wxSPLASH\_NO\_CENTRE
47\item wxSPLASH\_TIMEOUT
48\item wxSPLASH\_NO\_TIMEOUT
49\end{itemize}
50
51{\it milliseconds} is the timeout in milliseconds.
52
53\membersection{wxSplashScreen::\destruct{wxSplashScreen}}\label{wxsplashscreendtor}
54
55\func{}{\destruct{wxSplashScreen}}{\void}
56
57Destroys the splash screen.
58
59\membersection{wxSplashScreen::OnCloseWindow}\label{wxsplashscreenonclosewindow}
60
61\func{void}{OnCloseWindow}{\param{wxCloseEvent\& }{event}}
62
63Reimplement this event handler if you want to set an application variable on window destruction, for example.
64
65\membersection{wxSplashScreen::GetSplashStyle}\label{wxsplashscreengetsplashstyle}
66
67\constfunc{long}{GetSplashStyle}{\void}
68
69Returns the splash style (see \helpref{wxSplashScreen::wxSplashScreen}{wxsplashscreenwxsplashscreen} for
70details).
71
72\membersection{wxSplashScreen::GetSplashWindow}\label{wxsplashscreengetsplashwindow}
73
74\constfunc{wxSplashScreenWindow*}{GetSplashWindow}{\void}
75
76Returns the window used to display the bitmap.
77
78\membersection{wxSplashScreen::GetTimeout}\label{wxsplashscreengettimeout}
79
80\constfunc{int}{GetTimeout}{\void}
81
82Returns the timeout in milliseconds.
83