\section{File functions}\label{filefunctions}
-See also \helpref{wxPathList}{wxpathlist}.
+\wxheading{Include files}
+
+<wx/utils.h>
+
+\wxheading{See also}
+
+\helpref{wxPathList}{wxpathlist}
\membersection{::wxDirExists}
Returns the next file that matches the path passed to \helpref{wxFindFirstFile}{wxfindfirstfile}.
+\membersection{::wxGetOSDirectory}\label{wxgetosdirectory}
+
+\func{wxString}{wxGetOSDirectory}{\void}
+
+Returns the Windows directory under Windows; on other platforms returns the empty string.
+
\membersection{::wxIsAbsolutePath}
\func{bool}{wxIsAbsolutePath}{\param{const wxString\& }{filename}}
Copies {\it file1} to {\it file2}, returning TRUE if successful.
+\membersection{::wxGetCwd}\label{wxgetcwd}
+
+\func{wxString}{wxGetCwd}{\void}
+
+Returns a string containing the current (or working) directory.
+
\membersection{::wxGetHostName}\label{wxgethostname}
\func{bool}{wxGetHostName}{\param{const wxString\& }{buf}, \param{int }{sz}}
\func{wxString}{wxGetWorkingDirectory}{\param{const wxString\& }{buf=NULL}, \param{int }{sz=1000}}
+This function is obsolete: use \helpref{wxGetCwd}{wxgetcwd} instead.
+
Copies the current working directory into the buffer if supplied, or
copies the working directory into new storage (which you must delete yourself)
if the buffer is NULL.
Remember that the returned pointer is temporary and should be copied
if other wxWindows calls will be made before the value is to be used.
+\wxheading{Include files}
+
+<wx/filedlg.h>
+
\membersection{::wxGetTextFromUser}\label{wxgettextfromuser}
\func{wxString}{wxGetTextFromUser}{\param{const wxString\& }{message}, \param{const wxString\& }{caption = ``Input text"},\\
If {\it centre} is TRUE, the message text (which may include new line characters)
is centred; if FALSE, the message is left-justified.
+\wxheading{Include files}
+
+<wx/textdlg.h>
+
\membersection{::wxGetMultipleChoice}\label{wxgetmultiplechoice}
\func{int}{wxGetMultipleChoice}{\param{const wxString\& }{message}, \param{const wxString\& }{caption}, \param{int}{ n}, \param{const wxString\& }{choices[]},\\
If {\it centre} is TRUE, the message text (which may include new line characters)
is centred; if FALSE, the message is left-justified.
+\wxheading{Include files}
+
+<wx/choicdlg.h>
+
\membersection{::wxGetSingleChoice}\label{wxgetsinglechoice}
\func{wxString}{wxGetSingleChoice}{\param{const wxString\& }{message}, \param{const wxString\& }{caption}, \param{int}{ n}, \param{const wxString\& }{choices[]},\\
If {\it centre} is TRUE, the message text (which may include new line characters)
is centred; if FALSE, the message is left-justified.
+\wxheading{Include files}
+
+<wx/choicdlg.h>
+
\membersection{::wxGetSingleChoiceIndex}\label{wxgetsinglechoiceindex}
\func{int}{wxGetSingleChoiceIndex}{\param{const wxString\& }{message}, \param{const wxString\& }{caption}, \param{int}{ n}, \param{const wxString\& }{choices[]},\\
As {\bf wxGetSingleChoice} but returns the index representing the selected string.
If the user pressed cancel, -1 is returned.
+\wxheading{Include files}
+
+<wx/choicdlg.h>
+
\membersection{::wxGetSingleChoiceData}\label{wxgetsinglechoicedata}
\func{wxString}{wxGetSingleChoiceData}{\param{const wxString\& }{message}, \param{const wxString\& }{caption}, \param{int}{ n}, \param{const wxString\& }{choices[]},\\
As {\bf wxGetSingleChoice} but takes an array of client data pointers
corresponding to the strings, and returns one of these pointers.
+\wxheading{Include files}
+
+<wx/choicdlg.h>
+
\membersection{::wxMessageBox}\label{wxmessagebox}
\func{int}{wxMessageBox}{\param{const wxString\& }{message}, \param{const wxString\& }{caption = ``Message"}, \param{int}{ style = wxOK \pipe wxCENTRE},\\
This is because the native MessageBox function cannot centre text.
The symbols are not shown when the generic function is used.
+\wxheading{Include files}
+
+<wx/msgdlg.h>
+
\section{GDI functions}\label{gdifunctions}
The following are relevant to the GDI (Graphics Device Interface).
+\wxheading{Include files}
+
+<wx/gdicmn.h>
+
\membersection{::wxColourDisplay}
\func{bool}{wxColourDisplay}{\void}
SetWindowExt(dc, maxX - minX, maxY - minY);
\end{verbatim}
-This simulates the MM\_TEXT mapping mode, which wxWindows assumes.
+This simulates the wxMM\_TEXT mapping mode, which wxWindows assumes.
Placeable metafiles may be imported by many Windows applications, and can be
used in RTF (Rich Text Format) files.
The following functions are used to control PostScript printing. Under
Windows, PostScript output can only be sent to a file.
+\wxheading{Include files}
+
+<wx/dcps.h>
+
\membersection{::wxGetPrinterCommand}
\func{wxString}{wxGetPrinterCommand}{\void}
These clipboard functions are implemented for Windows only.
+\wxheading{Include files}
+
+<wx/clipbrd.h>
+
\membersection{::wxClipboardOpen}
\func{bool}{wxClipboardOpen}{\void}
\section{Miscellaneous functions}\label{miscellany}
-\membersection{::NewId}
+\membersection{::wxNewId}
-\func{long}{NewId}{\void}
+\func{long}{wxNewId}{\void}
Generates an integer identifier unique to this run of the program.
-\membersection{::RegisterId}
+\wxheading{Include files}
-\func{void}{RegisterId}{\param{long}{ id}}
+<wx/utils.h>
+
+\membersection{::wxRegisterId}
+
+\func{void}{wxRegisterId}{\param{long}{ id}}
Ensures that ids subsequently generated by {\bf NewId} do not clash with
the given {\bf id}.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxBeginBusyCursor}\label{wxbeginbusycursor}
\func{void}{wxBeginBusyCursor}{\param{wxCursor *}{cursor = wxHOURGLASS\_CURSOR}}
See also \helpref{wxIsBusy}{wxisbusy}, \helpref{wxBusyCursor}{wxbusycursor}.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxBell}
\func{void}{wxBell}{\void}
Ring the system bell.
-\membersection{::wxCleanUp}\label{wxcleanup}
-
-\func{void}{wxCleanUp}{\void}
+\wxheading{Include files}
-Normally, wxWindows will call this cleanup function for you. However, if
-you call \helpref{wxEntry}{wxentry} in order to initialize wxWindows
-manually, then you should also call wxCleanUp before terminating wxWindows,
-if wxWindows does not get a chance to do it.
+<wx/utils.h>
\membersection{::wxCreateDynamicObject}\label{wxcreatedynamicobject}
See also helpref{wxDDEInitialize}{wxddeinitialize}.
+\wxheading{Include files}
+
+<wx/dde.h>
+
\membersection{::wxDDEInitialize}\label{wxddeinitialize}
\func{void}{wxDDEInitialize}{\void}
See also \helpref{wxDDEServer}{wxddeserver}, \helpref{wxDDEClient}{wxddeclient}, \helpref{wxDDEConnection}{wxddeconnection},
\helpref{wxDDECleanUp}{wxddecleanup}.
+\wxheading{Include files}
+
+<wx/dde.h>
+
\membersection{::wxDebugMsg}\label{wxdebugmsg}
\func{void}{wxDebugMsg}{\param{const wxString\& }{fmt}, \param{...}{}}
This function is now obsolete, replaced by \helpref{Log functions}{logfunctions}.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxDisplaySize}
\func{void}{wxDisplaySize}{\param{int *}{width}, \param{int *}{height}}
Gets the physical size of the display in pixels.
+\wxheading{Include files}
+
+<wx/gdicmn.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. See also \helpref{wxCleanUp}{wxcleanup}.
+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 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{::wxError}\label{wxerror}
\func{void}{wxError}{\param{const wxString\& }{msg}, \param{const wxString\& }{title = "wxWindows Internal Error"}}
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{::wxEndBusyCursor}\label{wxendbusycursor}
\func{void}{wxEndBusyCursor}{\void}
See also \helpref{wxIsBusy}{wxisbusy}, \helpref{wxBusyCursor}{wxbusycursor}.
+\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}}
otherwise it is a status value. A zero value indicates that the command could not
be executed.
-If callback isn't NULL and if execution is asynchronous,
+If callback isn't NULL and if execution is asynchronous,
\helpref{wxProcess::OnTerminate}{wxprocessonterminate} will be called when
the process finishes.
See also \helpref{wxShell}{wxshell}, \helpref{wxProcess}{wxprocess}.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxExit}\label{wxexit}
\func{void}{wxExit}{\void}
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"}}
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}
\func{wxWindow *}{wxFindWindowByLabel}{\param{const wxString\& }{label}, \param{wxWindow *}{parent=NULL}}
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}}
If no such named window is found, {\bf wxFindWindowByLabel} is called.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\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}
\func{wxString}{wxGetHomeDir}{\param{const wxString\& }{buf}}
Fills the buffer with a string representing the user's home directory (Unix only).
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxGetHostName}
\func{bool}{wxGetHostName}{\param{const wxString\& }{buf}, \param{int}{ bufSize}}
successful. Under Unix, this will return a machine name. Under Windows,
this returns ``windows''.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxGetElapsedTime}\label{wxgetelapsedtime}
\func{long}{wxGetElapsedTime}{\param{bool}{ resetTimer = TRUE}}
See also \helpref{wxTimer}{wxtimer}.
+\wxheading{Include files}
+
+<wx/timer.h>
+
\membersection{::wxGetFreeMemory}\label{wxgetfreememory}
\func{long}{wxGetFreeMemory}{\void}
support it, and -1 if not supported. Currently, returns a positive value
under Windows, and -1 under Unix.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxGetMousePosition}
\func{void}{wxGetMousePosition}{\param{int* }{x}, \param{int* }{y}}
Returns the mouse position in screen coordinates.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxGetOsVersion}
\func{int}{wxGetOsVersion}{\param{int *}{major = NULL}, \param{int *}{minor = NULL}}
\twocolitem{Watcom C++ 386 supervisor mode (Windows 3.1)}{Return value is wxWIN386, {\it major} is 3, {\it minor} is 1.}
\end{twocollist}
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxGetResource}\label{wxgetresource}
\func{bool}{wxGetResource}{\param{const wxString\& }{section}, \param{const wxString\& }{entry},
See also \helpref{wxWriteResource}{wxwriteresource}, \helpref{wxConfigBase}{wxconfigbase}.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxGetUserId}
\func{bool}{wxGetUserId}{\param{const wxString\& }{buf}, \param{int}{ bufSize}}
buf}, of maximum size {\it bufSize}, returning TRUE if successful.
Under Windows, this returns ``user''.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxGetUserName}
\func{bool}{wxGetUserName}{\param{const wxString\& }{buf}, \param{int}{ bufSize}}
buf}, of maximum size {\it bufSize}, returning TRUE if successful.
Under Windows, this returns ``unknown''.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxKill}\label{wxkill}
\func{int}{wxKill}{\param{long}{ pid}, \param{int}{ sig}}
Tip: sending a signal of 0 to a process returns -1 if the process does not exist.
It does not raise a signal in the receiving process.
-\membersection{::wxInitClipboard}\label{wxinitclipboard}
+\wxheading{Include files}
-\func{void}{wxInitClipboard}{\void}
-
-Initializes the generic clipboard system by creating an instance of
-the class \helpref{wxClipboard}{wxclipboard}.
+<wx/utils.h>
\membersection{::wxIsBusy}\label{wxisbusy}
See also \helpref{wxBusyCursor}{wxbusycursor}.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxLoadUserResource}\label{wxloaduserresource}
\func{wxString}{wxLoadUserResource}{\param{const wxString\& }{resourceName}, \param{const wxString\& }{resourceType=``TEXT"}}
This function is available under Windows only.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxNow}\label{wxnow}
\func{wxString}{wxNow}{\void}
Returns a string representing the current date and time.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxPostDelete}\label{wxpostdelete}
\func{void}{wxPostDelete}{\param{wxObject *}{object}}
-Under X, tells the system to delete the specified object when
+Tells the system to delete the specified object when
all other events have been processed. In some environments, it is
necessary to use this instead of deleting a frame directly with the
-delete operator, because X will still send events to the window.
+delete operator, because some GUIs will still send events to a deleted window.
Now obsolete: use \helpref{wxWindow::Close}{wxwindowclose} instead.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxSetDisplayName}\label{wxsetdisplayname}
\func{void}{wxSetDisplayName}{\param{const wxString\& }{displayName}}
See also \helpref{wxGetDisplayName}{wxgetdisplayname}.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxShell}\label{wxshell}
\func{bool}{wxShell}{\param{const wxString\& }{command = NULL}}
See also \helpref{wxExecute}{wxexecute}.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxSleep}\label{wxsleep}
\func{void}{wxSleep}{\param{int}{ secs}}
Sleeps for the specified number of seconds.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxStripMenuCodes}
\func{wxString}{wxStripMenuCodes}{\param{const wxString\& }{in}}
Menu codes include \& (mark the next character with an underline
as a keyboard shortkey in Windows and Motif) and $\backslash$t (tab in Windows).
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxStartTimer}\label{wxstarttimer}
\func{void}{wxStartTimer}{\void}
See also \helpref{wxTimer}{wxtimer}.
+\wxheading{Include files}
+
+<wx/timer.h>
+
\membersection{::wxToLower}\label{wxtolower}
\func{char}{wxToLower}{\param{char }{ch}}
Converts the character to lower case. This is implemented as a macro for efficiency.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxToUpper}\label{wxtoupper}
\func{char}{wxToUpper}{\param{char }{ch}}
Converts the character to upper case. This is implemented as a macro for efficiency.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxTrace}\label{wxtrace}
\func{void}{wxTrace}{\param{const wxString\& }{fmt}, \param{...}{}}
This function is now obsolete, replaced by \helpref{Log functions}{logfunctions}.
+\wxheading{Include files}
+
+<wx/memory.h>
+
\membersection{::wxTraceLevel}\label{wxtracelevel}
\func{void}{wxTraceLevel}{\param{int}{ level}, \param{const wxString\& }{fmt}, \param{...}{}}
This function is now obsolete, replaced by \helpref{Log functions}{logfunctions}.
+\wxheading{Include files}
+
+<wx/memory.h>
+
\membersection{::wxWriteResource}\label{wxwriteresource}
\func{bool}{wxWriteResource}{\param{const wxString\& }{section}, \param{const wxString\& }{entry},
See also \helpref{wxGetResource}{wxgetresource}, \helpref{wxConfigBase}{wxconfigbase}.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\membersection{::wxYield}
\func{bool}{wxYield}{\void}
Disabling menu items or whole menus during processing can avoid unwanted
reentrance of code.
+\wxheading{Include files}
+
+<wx/utils.h>
+
\section{Macros}\label{macros}
These macros are defined in wxWindows.
Returns a pointer to the wxClassInfo object associated with this class.
+\wxheading{Include files}
+
+<wx/object.h>
+
\membersection{WXDEBUG\_NEW}\label{debugnew}
\func{}{WXDEBUG\_NEW}{arg}
In non-debug mode, this is defined as the normal new operator.
+\wxheading{Include files}
+
+<wx/object.h>
+
\membersection{DECLARE\_ABSTRACT\_CLASS}
\func{}{DECLARE\_ABSTRACT\_CLASS}{className}
};
\end{verbatim}
+\wxheading{Include files}
+
+<wx/object.h>
+
\membersection{DECLARE\_APP}\label{declareapp}
\func{}{DECLARE\_APP}{className}
DECLARE_APP(MyApp)
\end{verbatim}
+\wxheading{Include files}
+
+<wx/app.h>
+
\membersection{DECLARE\_CLASS}
\func{}{DECLARE\_CLASS}{className}
made known to the class hierarchy, but objects of this class cannot be created
dynamically. The same as DECLARE\_ABSTRACT\_CLASS.
+\wxheading{Include files}
+
+<wx/object.h>
+
\membersection{DECLARE\_DYNAMIC\_CLASS}
\func{}{DECLARE\_DYNAMIC\_CLASS}{className}
};
\end{verbatim}
+\wxheading{Include files}
+
+<wx/object.h>
+
\membersection{IMPLEMENT\_ABSTRACT\_CLASS}
\func{}{IMPLEMENT\_ABSTRACT\_CLASS}{className, baseClassName}
}
\end{verbatim}
+\wxheading{Include files}
+
+<wx/object.h>
+
\membersection{IMPLEMENT\_ABSTRACT\_CLASS2}
\func{}{IMPLEMENT\_ABSTRACT\_CLASS2}{className, baseClassName1, baseClassName2}
Used in a C++ implementation file to complete the declaration of
a class that has run-time type information and two base classes. The same as IMPLEMENT\_CLASS2.
+\wxheading{Include files}
+
+<wx/object.h>
+
\membersection{IMPLEMENT\_APP}\label{implementapp}
\func{}{IMPLEMENT\_APP}{className}
See also \helpref{DECLARE\_APP}{declareapp}.
+\wxheading{Include files}
+
+<wx/app.h>
+
\membersection{IMPLEMENT\_CLASS}
\func{}{IMPLEMENT\_CLASS}{className, baseClassName}
Used in a C++ implementation file to complete the declaration of
a class that has run-time type information. The same as IMPLEMENT\_ABSTRACT\_CLASS.
+\wxheading{Include files}
+
+<wx/object.h>
+
\membersection{IMPLEMENT\_CLASS2}
\func{}{IMPLEMENT\_CLASS2}{className, baseClassName1, baseClassName2}
class that has run-time type information and two base classes. The
same as IMPLEMENT\_ABSTRACT\_CLASS2.
+\wxheading{Include files}
+
+<wx/object.h>
+
\membersection{IMPLEMENT\_DYNAMIC\_CLASS}
\func{}{IMPLEMENT\_DYNAMIC\_CLASS}{className, baseClassName}
}
\end{verbatim}
+\wxheading{Include files}
+
+<wx/object.h>
+
\membersection{IMPLEMENT\_DYNAMIC\_CLASS2}
\func{}{IMPLEMENT\_DYNAMIC\_CLASS2}{className, baseClassName1, baseClassName2}
can be created dynamically. Use this for classes derived from two
base classes.
+\wxheading{Include files}
+
+<wx/object.h>
+
\membersection{WXTRACE}\label{trace}
\func{}{WXTRACE}{formatString, ...}
This macro is now obsolete, replaced by \helpref{Log functions}{logfunctions}.
+\wxheading{Include files}
+
+<wx/memory.h>
+
\membersection{WXTRACELEVEL}\label{tracelevel}
\func{}{WXTRACELEVEL}{level, formatString, ...}
This function is now obsolete, replaced by \helpref{Log functions}{logfunctions}.
+\wxheading{Include files}
+
+<wx/memory.h>
+
\section{wxWindows resource functions}\label{resourcefuncs}
\overview{wxWindows resource system}{resourceformats}
See also \helpref{wxWindow::LoadFromResource}{wxwindowloadfromresource} for
loading from resource data.
+{\bf Warning:} this needs updating for wxWindows 2.
+
\membersection{::wxResourceAddIdentifier}\label{wxresourceaddidentifier}
\func{bool}{wxResourceAddIdentifier}{\param{const wxString\& }{name}, \param{int }{value}}
These functions provide a variety of logging functions: see \helpref{Log classes overview}{wxlogoverview} for
further information.
+\wxheading{Include files}
+
+<wx/log.h>
+
\membersection{::wxLogError}\label{wxlogerror}
\func{void}{wxLogError}{\param{const char*}{ formatString}, \param{...}{}}
compiled if \_\_WXDEBUG\_\_ is defined, whereas CHECK macros stay in release
builds.
+\wxheading{Include files}
+
+<wx/debug.h>
+
\membersection{::wxOnAssert}\label{wxonassert}
\func{void}{wxOnAssert}{\param{const char*}{ fileName}, \param{int}{ lineNumber}, \param{const char*}{ msg = NULL}}
This function may be redefined to do something non trivial and is called
whenever one of debugging macros fails (i.e. condition is false in an
-assertion). TODO: this should probably be an overridable in wxApp.
+assertion).
+% TODO: this should probably be an overridable in wxApp.
\membersection{wxASSERT}\label{wxassert}