X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/09914df7b85fe17845223b291ab65925dceba6f2..c958260b3886cb83aa93c7508d0986c6433ce165:/docs/latex/wx/tlog.tex?ds=sidebyside diff --git a/docs/latex/wx/tlog.tex b/docs/latex/wx/tlog.tex index 0cdc287607..7db8f6c4ee 100644 --- a/docs/latex/wx/tlog.tex +++ b/docs/latex/wx/tlog.tex @@ -1,10 +1,7 @@ -\section{Log classes overview}\label{wxlogoverview} +\section{wxLog classes overview}\label{wxlogoverview} -Classes: \helpref{wxLog}{wxlog}\\ -\helpref{wxLogStderr}{wxlogstderr},\\ -\helpref{wxLogOstream}{wxlogostream}, \helpref{wxLogTextCtrl}{wxlogtextctrl},\\ -\helpref{wxLogWindow}{wxlogwindow}, \helpref{wxLogGui}{wxloggui},\\ -\helpref{wxLogNull}{wxlognull} +Classes: \helpref{wxLog}{wxlog}, wxLogStderr, +wxLogOstream, wxLogTextCtrl, wxLogWindow, wxLogGui, wxLogNull This is a general overview of logging classes provided by wxWindows. The word logging here has a broad sense, including all of the program output, not only @@ -47,6 +44,9 @@ first argument. \item{\bf wxLogDebug} is {\bf the} right function for debug output. It only does anything at all in the debug mode (when the preprocessor symbol \_\_WXDEBUG\_\_ is defined) and expands to nothing in release mode (otherwise). +{\bf Tip:} under Windows, you must either run the program under debugger or +use a 3rd party program such as \urlref{DbgView}{http://www.sysinternals.com} +to actually see the debug output. \item{\bf wxLogTrace} as {\bf wxLogDebug} only does something in debug build. The reason for making it a separate function from it is that usually there are a lot of trace messages, so it might make sense to separate them @@ -92,7 +92,7 @@ works. wxWindows has the notion of a {\it log target}: it's just a class deriving from \helpref{wxLog}{wxlog}. As such, it implements the virtual functions of the base class which are called when a message is logged. Only one log target -is {\it active} at any moment, this is the one used by \it{wxLogXXX()} +is {\it active} at any moment, this is the one used by {\it wxLogXXX()} functions. The normal usage of a log object (i.e. object of a class derived from wxLog) is to install it as the active target with a call to {\it SetActiveTarget()} and it will be used automatically by all subsequent calls