X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ac7f0167aaced8162b8f40725102b5900681ce23..80d2803f703d1b238f42725504f08266ef02defe:/docs/latex/wx/log.tex diff --git a/docs/latex/wx/log.tex b/docs/latex/wx/log.tex index 3c8d763200..03c4fa98bc 100644 --- a/docs/latex/wx/log.tex +++ b/docs/latex/wx/log.tex @@ -62,13 +62,14 @@ without writing a new log target class (which, aside of being a matter of several minutes, allows you to do anything you want). The verbose messages are the trace messages which are not disabled in the -release mode and are generated by \helpref{wxLogVerbose}{wxlogverbose}. They are not normally -shown to the user because they present little interest, but may be activated, -for example, in order to help the user find some program problem. +release mode and are generated by \helpref{wxLogVerbose}{wxlogverbose}. They +are not normally shown to the user because they present little interest, but +may be activated, for example, in order to help the user find some program +problem. As for the (real) trace messages, their handling depends on the settings of the (application global) {\it trace mask}. There are two ways to specify it: -either by using helpref{SetTraceMask}{wxlogsettracemask} and +either by using \helpref{SetTraceMask}{wxlogsettracemask} and \helpref{GetTraceMask}{wxloggettracemask} and using \helpref{wxLogTrace}{wxlogtrace} which takes an integer mask or by using \helpref{AddTraceMask}{wxlogaddtracemask} for string trace masks. @@ -79,17 +80,21 @@ current mask while a message using string mask will be logged simply if the mask had been added before to the list of allowed ones. For example, + \begin{verbatim} // wxTraceOleCalls is one of standard bit masks wxLogTrace(wxTraceRefCount | wxTraceOleCalls, "Active object ref count: %d", nRef); \end{verbatim} will do something only if the current trace mask contains both {\tt wxTraceRefCount} and {\tt wxTraceOle}, but + \begin{verbatim} // wxTRACE_OleCalls is one of standard string masks -wxLogTrace(wxTACE_OleCalls, "IFoo::Bar() called"); +wxLogTrace(wxTRACE_OleCalls, "IFoo::Bar() called"); \end{verbatim} + will log the message if it was preceded by + \begin{verbatim} wxLog::AddTraceMask(wxTRACE_OleCalls); \end{verbatim}