X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/411165f3f40f411d6feba4d13d4934f7fff6cc4f..ab9717339232a7a728dea666c59b73fd6ac78dd3:/docs/latex/wx/process.tex diff --git a/docs/latex/wx/process.tex b/docs/latex/wx/process.tex index e3ced73249..771d57a141 100644 --- a/docs/latex/wx/process.tex +++ b/docs/latex/wx/process.tex @@ -28,12 +28,17 @@ for explicit destruction.} \wxheading{Derived from} -\helpref{wxEvtHandler}{wxevthandler} +\helpref{wxEvtHandler}{wxevthandler}\\ +\helpref{wxObject}{wxobject} \wxheading{Include files} +\wxheading{Library} + +\helpref{wxBase}{librarieslist} + \wxheading{See also} \helpref{wxExecute}{wxexecute}\\ @@ -41,14 +46,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 +74,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 +130,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 +141,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 +156,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 +190,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 +218,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 +227,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 +238,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 @@ -255,6 +265,12 @@ A pointer to new wxProcess object or {\tt NULL} on error. \helpref{wxExecute}{wxexecute} +\membersection{wxProcess::GetPid}\label{wxprocessgetpid} + +\constfunc{long}{GetPid}{\void} + +Returns the process ID of the process launched by \helpref{Open}{wxprocessopen}. + \membersection{wxProcess::Redirect}\label{wxprocessredirect} \func{void}{Redirect}{\void}