]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/process.tex
don't use _T() inside wxGetTranslation() and related macros (wxTRANSLATE, _, ......
[wxWidgets.git] / docs / latex / wx / process.tex
index e3ced7324959927c78bca80110eb43545ebc3cd9..771d57a1417e56978ceb9faefc59b1c304e84ffa 100644 (file)
@@ -28,12 +28,17 @@ for explicit destruction.}
 
 \wxheading{Derived from}
 
-\helpref{wxEvtHandler}{wxevthandler}
+\helpref{wxEvtHandler}{wxevthandler}\\
+\helpref{wxObject}{wxobject}
 
 \wxheading{Include files}
 
 <wx/process.h>
 
+\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}