X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/411165f3f40f411d6feba4d13d4934f7fff6cc4f..917be7ed065337e8a7a67615969ecaade9eea809:/docs/latex/wx/process.tex?ds=sidebyside diff --git a/docs/latex/wx/process.tex b/docs/latex/wx/process.tex index e3ced73249..d19b33a4b0 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} @@ -125,7 +125,7 @@ See \helpref{wxProcess::Redirect}{wxprocessredirect}. \constfunc{bool}{IsErrorAvailable}{\void} -Returns {\tt TRUE} if there is data to be read on the child process standard +Returns {\tt true} if there is data to be read on the child process standard error stream. \wxheading{See also} @@ -136,9 +136,9 @@ error stream. \constfunc{bool}{IsInputAvailable}{\void} -Returns {\tt TRUE} if there is data to be read on the child process standard +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. @@ -151,11 +151,11 @@ function. \constfunc{bool}{IsInputOpened}{\void} -Returns {\tt TRUE} if the child process standard output stream is opened. +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} @@ -208,7 +213,7 @@ enum wxKillError \func{static bool}{Exists}{\param{int}{ pid}} -Returns {\tt TRUE} if the given process exists in the system. +Returns {\tt true} if the given process exists in the system. \wxheading{See also} @@ -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