X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/cc81d32f2bf8c159f3b1bf6ddaf62e6d77720209..6eb1fe1cc4bd56cb7c06d68ddf003c5c043468ba:/docs/latex/wx/process.tex?ds=sidebyside diff --git a/docs/latex/wx/process.tex b/docs/latex/wx/process.tex index 6a9f9d0dc9..4f94f2b2a6 100644 --- a/docs/latex/wx/process.tex +++ b/docs/latex/wx/process.tex @@ -41,14 +41,14 @@ for explicit destruction.} \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxProcess::wxProcess}\label{wxprocessconstr} +\membersection{wxProcess::wxProcess}\label{wxprocessctor} \func{}{wxProcess}{\param{wxEvtHandler *}{ parent = NULL}, \param{int}{ id = -1}} \func{}{wxProcess}{\param{int }{flags}} Constructs a process object. {\it id} is only used in the case you want to -use wxWindows events. It identifies this object, or another window that will +use wxWidgets events. It identifies this object, or another window that will receive the event. If the {\it parent} parameter is different from NULL, it will receive @@ -69,7 +69,7 @@ to calling \helpref{Redirect}{wxprocessredirect}. \docparam{flags}{either {\tt wxPROCESS\_DEFAULT} or {\tt wxPROCESS\_REDIRECT}} -\membersection{wxProcess::\destruct{wxProcess}} +\membersection{wxProcess::\destruct{wxProcess}}\label{wxprocessdtor} \func{}{\destruct{wxProcess}}{\void} @@ -138,7 +138,7 @@ error stream. Returns {\tt true} if there is data to be read on the child process standard output stream. This allows to write simple (and extremely inefficient) -polling-based code waiting for a better mechanism in future wxWindows versions. +polling-based code waiting for a better mechanism in future wxWidgets versions. See the \helpref{exec sample}{sampleexec} for an example of using this function. @@ -155,7 +155,7 @@ Returns {\tt true} if the child process standard output stream is opened. \membersection{wxProcess::Kill}\label{wxprocesskill} -\func{static wxKillError}{Kill}{\param{int}{ pid}, \param{wxSignal}{ signal = wxSIGNONE}} +\func{static wxKillError}{Kill}{\param{int}{ pid}, \param{wxSignal}{ signal = wxSIGNONE}, \param{int }{flags = wxKILL\_NOCHILDREN}} Send the specified signal to the given process. Possible signal values are: @@ -185,6 +185,11 @@ enum wxSignal under both Unix and Windows but all the other signals are equivalent to {\tt wxSIGTERM} under Windows. +The {\it flags} parameter can be wxKILL\_NOCHILDREN (the default), +or wxKILL\_CHILDREN, in which case the child processes of this +process will be killed too. Note that under Unix, for wxKILL\_CHILDREN +to work you should have created the process passing wxEXEC\_MAKE\_GROUP\_LEADER. + Returns the element of {\tt wxKillError} enum: \begin{verbatim} @@ -217,10 +222,10 @@ Returns {\tt true} if the given process exists in the system. \membersection{wxProcess::OnTerminate}\label{wxprocessonterminate} -\constfunc{void}{OnTerminate}{\param{int}{ pid}, \param{int}{ status}} +\func{void}{OnTerminate}{\param{int}{ pid}, \param{int}{ status}} It is called when the process with the pid {\it pid} finishes. -It raises a wxWindows event when it isn't overridden. +It raises a wxWidgets event when it isn't overridden. \docparam{pid}{The pid of the process which has just terminated.} @@ -228,7 +233,7 @@ It raises a wxWindows event when it isn't overridden. \membersection{wxProcess::Open}\label{wxprocessopen} -\func{static wxProcess *}{Open}{\param{const wxString\& }{cmd} \param{int }{flags = wxEXEC\_ASYNC}} +\func{static wxProcess *}{Open}{\param{const wxString\& }{cmd}, \param{int }{flags = wxEXEC\_ASYNC}} This static method replaces the standard {\tt popen()} function: it launches the process specified by the {\it cmd} parameter and returns the wxProcess