added wxLog functions with a variable argument list pointer
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@13562 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
@@ -1186,7 +1186,7 @@ Converts the character to upper case. This is implemented as a macro for efficie
|
||||
|
||||
\membersection{::wxVsnprintf}\label{wxvsnprintf}
|
||||
|
||||
\func{int}{wxVsnprintf}{\param{wxChar *}{buf}, \param{size\_t }{len}, \param{const wxChar *}{format}, \param{va\_list }{argptr}}
|
||||
\func{int}{wxVsnprintf}{\param{wxChar *}{buf}, \param{size\_t }{len}, \param{const wxChar *}{format}, \param{va\_list }{argPtr}}
|
||||
|
||||
The same as \helpref{wxSnprintf}{wxsnprintf} but takes a {\tt va\_list}
|
||||
argument instead of arbitrary number of parameters.
|
||||
@@ -2955,14 +2955,16 @@ wxWindows errors. See also \helpref{wxError}{wxerror}.
|
||||
\membersection{::wxLogError}\label{wxlogerror}
|
||||
|
||||
\func{void}{wxLogError}{\param{const char*}{ formatString}, \param{...}{}}
|
||||
\func{void}{wxLogError}{\param{const char*}{ formatString}, \param{va_list}{argPtr}}
|
||||
|
||||
The function to use for error messages, i.e. the messages that must be shown
|
||||
The functions to use for error messages, i.e. the messages that must be shown
|
||||
to the user. The default processing is to pop up a message box to inform the
|
||||
user about it.
|
||||
|
||||
\membersection{::wxLogFatalError}\label{wxlogfatalerror}
|
||||
|
||||
\func{void}{wxLogFatalError}{\param{const char*}{ formatString}, \param{...}{}}
|
||||
\func{void}{wxLogFatalError}{\param{const char*}{ formatString}, \param{va_list}{argPtr}}
|
||||
|
||||
Like \helpref{wxLogError}{wxlogerror}, but also
|
||||
terminates the program with the exit code 3. Using {\it abort()} standard
|
||||
@@ -2971,6 +2973,7 @@ function also terminates the program with this exit code.
|
||||
\membersection{::wxLogWarning}\label{wxlogwarning}
|
||||
|
||||
\func{void}{wxLogWarning}{\param{const char*}{ formatString}, \param{...}{}}
|
||||
\func{void}{wxLogWarning}{\param{const char*}{ formatString}, \param{va_list}{argPtr}}
|
||||
|
||||
For warnings - they are also normally shown to the user, but don't interrupt
|
||||
the program work.
|
||||
@@ -2978,8 +2981,9 @@ the program work.
|
||||
\membersection{::wxLogMessage}\label{wxlogmessage}
|
||||
|
||||
\func{void}{wxLogMessage}{\param{const char*}{ formatString}, \param{...}{}}
|
||||
\func{void}{wxLogMessage}{\param{const char*}{ formatString}, \param{va_list}{argPtr}}
|
||||
|
||||
for all normal, informational messages. They also appear in a message box by
|
||||
For all normal, informational messages. They also appear in a message box by
|
||||
default (but it can be changed). Notice that the standard behaviour is to not
|
||||
show informational messages if there are any errors later - the logic being
|
||||
that the later error messages make the informational messages preceding them
|
||||
@@ -2988,6 +2992,7 @@ meaningless.
|
||||
\membersection{::wxLogVerbose}\label{wxlogverbose}
|
||||
|
||||
\func{void}{wxLogVerbose}{\param{const char*}{ formatString}, \param{...}{}}
|
||||
\func{void}{wxLogVerbose}{\param{const char*}{ formatString}, \param{va_list}{argPtr}}
|
||||
|
||||
For verbose output. Normally, it is suppressed, but
|
||||
might be activated if the user wishes to know more details about the program
|
||||
@@ -2996,18 +3001,21 @@ progress (another, but possibly confusing name for the same function is {\bf wxL
|
||||
\membersection{::wxLogStatus}\label{wxlogstatus}
|
||||
|
||||
\func{void}{wxLogStatus}{\param{wxFrame *}{frame}, \param{const char*}{ formatString}, \param{...}{}}
|
||||
\func{void}{wxLogStatus}{\param{wxFrame *}{frame}, \param{const char*}{ formatString}, \param{va_list}{argPtr}}
|
||||
|
||||
\func{void}{wxLogStatus}{\param{const char*}{ formatString}, \param{...}{}}
|
||||
\func{void}{wxLogStatus}{\param{const char*}{ formatString}, \param{va_list}{argPtr}}
|
||||
|
||||
Messages logged by this function will appear in the statusbar of the {\it
|
||||
Messages logged by these functions will appear in the statusbar of the {\it
|
||||
frame} or of the top level application window by default (i.e. when using
|
||||
the second version of the function).
|
||||
the second version of the functions).
|
||||
|
||||
If the target frame doesn't have a statusbar, the message will be lost.
|
||||
|
||||
\membersection{::wxLogSysError}\label{wxlogsyserror}
|
||||
|
||||
\func{void}{wxLogSysError}{\param{const char*}{ formatString}, \param{...}{}}
|
||||
\func{void}{wxLogSysError}{\param{const char*}{ formatString}, \param{va_list}{argPtr}}
|
||||
|
||||
Mostly used by wxWindows itself, but might be handy for logging errors after
|
||||
system call (API function) failure. It logs the specified message text as well
|
||||
@@ -3023,18 +3031,22 @@ of this function takes the error code explicitly as the first argument.
|
||||
\membersection{::wxLogDebug}\label{wxlogdebug}
|
||||
|
||||
\func{void}{wxLogDebug}{\param{const char*}{ formatString}, \param{...}{}}
|
||||
\func{void}{wxLogDebug}{\param{const char*}{ formatString}, \param{va_list}{argPtr}}
|
||||
|
||||
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
|
||||
The right functions for debug output. They only do something in debug
|
||||
mode (when the preprocessor symbol \_\_WXDEBUG\_\_ is defined) and expand to
|
||||
nothing in release mode (otherwise).
|
||||
|
||||
\membersection{::wxLogTrace}\label{wxlogtrace}
|
||||
|
||||
\func{void}{wxLogTrace}{\param{const char*}{ formatString}, \param{...}{}}
|
||||
\func{void}{wxLogTrace}{\param{const char*}{ formatString}, \param{va_list}{argPtr}}
|
||||
|
||||
\func{void}{wxLogTrace}{\param{const char *}{mask}, \param{const char *}{formatString}, \param{...}{}}
|
||||
\func{void}{wxLogTrace}{\param{const char *}{mask}, \param{const char *}{formatString}, \param{va_list}{argPtr}}
|
||||
|
||||
\func{void}{wxLogTrace}{\param{wxTraceMask}{ mask}, \param{const char *}{formatString}, \param{...}{}}
|
||||
\func{void}{wxLogTrace}{\param{wxTraceMask}{ mask}, \param{const char *}{formatString}, \param{va_list}{argPtr}}
|
||||
|
||||
As {\bf wxLogDebug}, trace functions only do something in debug build and
|
||||
expand to nothing in the release one. The reason for making
|
||||
|
Reference in New Issue
Block a user