-This function enables or disables all top level windows. It is used by
-\helpref{::wxSafeYield}{wxsafeyield}.
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxEntry}\label{wxentry}
-
-This initializes wxWindows in a platform-dependent way. Use this if you
-are not using the default wxWindows entry code (e.g. main or WinMain). For example,
-you can initialize wxWindows from an Microsoft Foundation Classes application using
-this function.
-
-\func{void}{wxEntry}{\param{HANDLE}{ hInstance}, \param{HANDLE}{ hPrevInstance},
- \param{const wxString\& }{commandLine}, \param{int}{ cmdShow}, \param{bool}{ enterLoop = TRUE}}
-
-wxWindows initialization under Windows (non-DLL). If {\it enterLoop} is FALSE, the
-function will return immediately after calling wxApp::OnInit. Otherwise, the wxWindows
-message loop will be entered.
-
-\func{void}{wxEntry}{\param{HANDLE}{ hInstance}, \param{HANDLE}{ hPrevInstance},
- \param{WORD}{ wDataSegment}, \param{WORD}{ wHeapSize}, \param{const wxString\& }{ commandLine}}
-
-wxWindows initialization under Windows (for applications constructed as a DLL).
-
-\func{int}{wxEntry}{\param{int}{ argc}, \param{const wxString\& *}{argv}}
-
-wxWindows initialization under Unix.
-
-\wxheading{Remarks}
-
-To clean up wxWindows, call wxApp::OnExit followed by the static function
-wxApp::CleanUp. For example, if exiting from an MFC application that also uses wxWindows:
-
-\begin{verbatim}
-int CTheApp::ExitInstance()
-{
- // OnExit isn't called by CleanUp so must be called explicitly.
- wxTheApp->OnExit();
- wxApp::CleanUp();
-
- return CWinApp::ExitInstance();
-}
-\end{verbatim}
-
-\wxheading{Include files}
-
-<wx/app.h>
-
-\membersection{::wxEndBusyCursor}\label{wxendbusycursor}
-
-\func{void}{wxEndBusyCursor}{\void}
-
-Changes the cursor back to the original cursor, for all windows in the application.
-Use with \helpref{wxBeginBusyCursor}{wxbeginbusycursor}.
-
-See also \helpref{wxIsBusy}{wxisbusy}, \helpref{wxBusyCursor}{wxbusycursor}.
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxError}\label{wxerror}
-
-\func{void}{wxError}{\param{const wxString\& }{msg}, \param{const wxString\& }{title = "wxWindows Internal Error"}}
-
-Displays {\it msg} and continues. This writes to standard error under
-Unix, and pops up a message box under Windows. Used for internal
-wxWindows errors. See also \helpref{wxFatalError}{wxfatalerror}.
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxExecute}\label{wxexecute}
-
-\func{long}{wxExecute}{\param{const wxString\& }{command}, \param{bool }{sync = FALSE}, \param{wxProcess *}{callback = NULL}}
-
-\func{long}{wxExecute}{\param{char **}{argv}, \param{bool }{sync = FALSE}, \param{wxProcess *}{callback = NULL}}
-
-\func{long}{wxExecute}{\param{const wxString\& }{command}, \param{wxArrayString\& }{output}}
-
-\func{long}{wxExecute}{\param{const wxString\& }{command}, \param{wxArrayString\& }{output}, \param{wxArrayString\& }{errors}}
-
-Executes another program in Unix or Windows.
-
-The first form takes a command string, such as {\tt "emacs file.txt"}.
-
-The second form takes an array of values: a command, any number of
-arguments, terminated by NULL.
-
-The semantics of the third and fourth versions is different from the first two
-and is described in more details below.
-
-If {\it sync} is FALSE (the default), flow of control immediately returns.
-If TRUE, the current application waits until the other program has terminated.
-
-In the case of synchronous execution, the return value is the exit code of
-the process (which terminates by the moment the function returns) and will be
-$-1$ if the process couldn't be started and typically 0 if the process
-terminated successfully. Also, while waiting for the process to
-terminate, wxExecute will call \helpref{wxYield}{wxyield}. The caller
-should ensure that this can cause no recursion, in the simplest case by
-calling \helpref{wxEnableTopLevelWindows(FALSE)}{wxenabletoplevelwindows}.
-
-For asynchronous execution, however, the return value is the process id and
-zero value indicates that the command could not be executed.
-
-If callback isn't NULL and if execution is asynchronous (note that callback
-parameter can not be non-NULL for synchronous execution),
-\helpref{wxProcess::OnTerminate}{wxprocessonterminate} will be called when
-the process finishes.
-
-Finally, you may use the third overloaded version of this function to execute
-a process (always synchronously) and capture its output in the array
-{\it output}. The fourth version adds the possibility to additionally capture
-the messages from standard error output in the {\it errors} array.
-
-See also \helpref{wxShell}{wxshell}, \helpref{wxProcess}{wxprocess},
-\helpref{Exec sample}{sampleexec}.
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxExit}\label{wxexit}
-
-\func{void}{wxExit}{\void}
-
-Exits application after calling \helpref{wxApp::OnExit}{wxapponexit}.
-Should only be used in an emergency: normally the top-level frame
-should be deleted (after deleting all other frames) to terminate the
-application. See \helpref{wxWindow::OnCloseWindow}{wxwindowonclosewindow} and \helpref{wxApp}{wxapp}.
-
-\wxheading{Include files}
-
-<wx/app.h>
-
-\membersection{::wxFatalError}\label{wxfatalerror}
-
-\func{void}{wxFatalError}{\param{const wxString\& }{msg}, \param{const wxString\& }{title = "wxWindows Fatal Error"}}
-
-Displays {\it msg} and exits. This writes to standard error under Unix,
-and pops up a message box under Windows. Used for fatal internal
-wxWindows errors. See also \helpref{wxError}{wxerror}.
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxFindMenuItemId}
-
-\func{int}{wxFindMenuItemId}{\param{wxFrame *}{frame}, \param{const wxString\& }{menuString}, \param{const wxString\& }{itemString}}
-
-Find a menu item identifier associated with the given frame's menu bar.
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxFindWindowByLabel}\label{wxfindwindowbylabel}
-
-\func{wxWindow *}{wxFindWindowByLabel}{\param{const wxString\& }{label}, \param{wxWindow *}{parent=NULL}}
-
-Find a window by its label. Depending on the type of window, the label may be a window title
-or panel item label. If {\it parent} is NULL, the search will start from all top-level
-frames and dialog boxes; if non-NULL, the search will be limited to the given window hierarchy.
-The search is recursive in both cases.
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxFindWindowByName}\label{wxfindwindowbyname}
-
-\func{wxWindow *}{wxFindWindowByName}{\param{const wxString\& }{name}, \param{wxWindow *}{parent=NULL}}
-
-Find a window by its name (as given in a window constructor or {\bf Create} function call).
-If {\it parent} is NULL, the search will start from all top-level
-frames and dialog boxes; if non-NULL, the search will be limited to the given window hierarchy.
-The search is recursive in both cases.
-
-If no such named window is found, {\bf wxFindWindowByLabel} is called.
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxFindWindowAtPoint}\label{wxfindwindowatpoint}
-
-\func{wxWindow *}{wxFindWindowAtPoint}{\param{const wxPoint\& }{pt}}
-
-Find the deepest window at the given mouse position in screen coordinates,
-returning the window if found, or NULL if not.
-
-\membersection{::wxFindWindowAtPointer}\label{wxfindwindowatpointer}
-
-\func{wxWindow *}{wxFindWindowAtPointer}{\param{wxPoint\& }{pt}}
-
-Find the deepest window at the mouse pointer position, returning the window
-and current pointer position in screen coordinates.
-
-\membersection{::wxGetActiveWindow}\label{wxgetactivewindow}
-
-\func{wxWindow *}{wxGetActiveWindow}{\void}
-
-Gets the currently active window (Windows only).
-
-\wxheading{Include files}
-
-<wx/windows.h>
-
-\membersection{::wxGetDisplayName}\label{wxgetdisplayname}
-
-\func{wxString}{wxGetDisplayName}{\void}
-
-Under X only, returns the current display name. See also \helpref{wxSetDisplayName}{wxsetdisplayname}.
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxGetHomeDir}\label{wxgethomedir}
-
-\func{wxString}{wxGetHomeDir}{\void}
-
-Return the (current) user's home directory.
-
-\wxheading{See also}
-
-\helpref{wxGetUserHome}{wxgetuserhome}
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxGetFreeMemory}\label{wxgetfreememory}
-
-\func{long}{wxGetFreeMemory}{\void}
-
-Returns the amount of free memory in bytes under environments which
-support it, and -1 if not supported. Currently, it is supported only
-under Windows, Linux and Solaris.
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxGetMousePosition}\label{wxgetmouseposition}
-
-\func{wxPoint}{wxGetMousePosition}{\void}
-
-Returns the mouse position in screen coordinates.
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxGetOsDescription}\label{wxgetosdescription}
-
-\func{wxString}{wxGetOsDescription}{\void}
-
-Returns the string containing the description of the current platform in a
-user-readable form. For example, this function may return strings like
-{\tt Windows NT Version 4.0} or {\tt Linux 2.2.2 i386}.
-
-\wxheading{See also}
-
-\helpref{::wxGetOsVersion}{wxgetosversion}
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxGetOsVersion}\label{wxgetosversion}
-
-\func{int}{wxGetOsVersion}{\param{int *}{major = NULL}, \param{int *}{minor = NULL}}
-
-Gets operating system version information.
-
-\begin{twocollist}\itemsep=0pt
-\twocolitemruled{Platform}{Return types}
-\twocolitem{Macintosh}{Return value is wxMACINTOSH.}
-\twocolitem{GTK}{Return value is wxGTK, For GTK 1.0, {\it major} is 1, {\it minor} is 0. }
-\twocolitem{Motif}{Return value is wxMOTIF\_X, {\it major} is X version, {\it minor} is X revision.}
-\twocolitem{OS/2}{Return value is wxOS2\_PM.}
-\twocolitem{Windows 3.1}{Return value is wxWINDOWS, {\it major} is 3, {\it minor} is 1.}
-\twocolitem{Windows NT/2000}{Return value is wxWINDOWS\_NT, version is returned in {\it major} and {\it minor}}
-\twocolitem{Windows 98}{Return value is wxWIN95, {\it major} is 4, {\it minor} is 1 or greater.}
-\twocolitem{Windows 95}{Return value is wxWIN95, {\it major} is 4, {\it minor} is 0.}
-\twocolitem{Win32s (Windows 3.1)}{Return value is wxWIN32S, {\it major} is 3, {\it minor} is 1.}
-\twocolitem{Watcom C++ 386 supervisor mode (Windows 3.1)}{Return value is wxWIN386, {\it major} is 3, {\it minor} is 1.}
-\end{twocollist}
-
-\wxheading{See also}
-
-\helpref{::wxGetOsDescription}{wxgetosdescription}
-
-\wxheading{Include files}
-
-<wx/utils.h>
-
-\membersection{::wxGetResource}\label{wxgetresource}
-
-\func{bool}{wxGetResource}{\param{const wxString\& }{section}, \param{const wxString\& }{entry},
- \param{const wxString\& *}{value}, \param{const wxString\& }{file = NULL}}
-
-\func{bool}{wxGetResource}{\param{const wxString\& }{section}, \param{const wxString\& }{entry},
- \param{float *}{value}, \param{const wxString\& }{file = NULL}}
-
-\func{bool}{wxGetResource}{\param{const wxString\& }{section}, \param{const wxString\& }{entry},
- \param{long *}{value}, \param{const wxString\& }{file = NULL}}
-
-\func{bool}{wxGetResource}{\param{const wxString\& }{section}, \param{const wxString\& }{entry},
- \param{int *}{value}, \param{const wxString\& }{file = NULL}}
-
-Gets a resource value from the resource database (for example, WIN.INI, or
-.Xdefaults). If {\it file} is NULL, WIN.INI or .Xdefaults is used,
-otherwise the specified file is used.
-
-Under X, if an application class (wxApp::GetClassName) has been defined,
-it is appended to the string /usr/lib/X11/app-defaults/ to try to find
-an applications default file when merging all resource databases.
-
-The reason for passing the result in an argument is that it
-can be convenient to define a default value, which gets overridden
-if the value exists in the resource file. It saves a separate
-test for that resource's existence, and it also allows
-the overloading of the function for different types.
-
-See also \helpref{wxWriteResource}{wxwriteresource}, \helpref{wxConfigBase}{wxconfigbase}.