X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/392751754e224616f01ce454830177b7a2b24b2b..4fcbc84d657413b157ac3ef89bf8fbccbcf899ba:/docs/latex/wx/ipcconn.tex diff --git a/docs/latex/wx/ipcconn.tex b/docs/latex/wx/ipcconn.tex index fae020bbd5..f977f8da9f 100644 --- a/docs/latex/wx/ipcconn.tex +++ b/docs/latex/wx/ipcconn.tex @@ -1,9 +1,9 @@ -\section{\class{wxConnection}}\label{wxddeconnection} +\section{\class{wxConnection}}\label{wxconnection} A wxConnection object represents the connection between a client and a server. It is created by making a connection using a\rtfsp -\helpref{wxClient}{wxddeclient} object, or by the acceptance of a -connection by a\rtfsp \helpref{wxServer}{wxddeserver} object. The +\helpref{wxClient}{wxclient} object, or by the acceptance of a +connection by a\rtfsp \helpref{wxServer}{wxserver} object. The bulk of a DDE-like (Dynamic Data Exchange) conversation is controlled by calling members in a {\bf wxConnection} object or by overriding its members. The actual DDE-based implementation @@ -54,12 +54,12 @@ enum wxIPCFormat \wxheading{See also} -\helpref{wxClient}{wxddeclient}, \helpref{wxServer}{wxddeserver}, +\helpref{wxClient}{wxclient}, \helpref{wxServer}{wxserver}, \helpref{Interprocess communications overview}{ipcoverview} \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxConnection::wxConnection} +\membersection{wxConnection::wxConnection}\label{wxconnectionctor} \func{}{wxConnection}{\void} @@ -71,7 +71,7 @@ should not be called directly, since the default connection object will be provided on requesting (or accepting) a connection. However, if the user defines his or her own derived connection object, the \helpref{wxServer::OnAcceptConnection}{wxserveronacceptconnection}\rtfsp -and/or \helpref{wxClient::OnMakeConnection}{wxddeclientonmakeconnection} +and/or \helpref{wxClient::OnMakeConnection}{wxclientonmakeconnection} members should be replaced by functions which construct the new connection object. @@ -82,45 +82,45 @@ be increased if necessary, and the program will assert if it is not large enough. The programmer-supplied buffer is included mainly for backwards compatibility. -\membersection{wxConnection::Advise}\label{wxddeconnectionadvise} +\membersection{wxConnection::Advise}\label{wxconnectionadvise} -\func{bool}{Advise}{\param{const wxString\& }{item}, \param{char* }{data}, \param{int}{ size = -1}, \param{wxIPCFormat}{ format = wxCF\_TEXT}} +\func{bool}{Advise}{\param{const wxString\& }{item}, \param{const char* }{data}, \param{int}{ size = -1}, \param{wxIPCFormat}{ format = wxCF\_TEXT}} Called by the server application to advise the client of a change in the data associated with the given item. Causes the client -connection's \helpref{wxConnection::OnAdvise}{wxddeconnectiononadvise} member +connection's \helpref{wxConnection::OnAdvise}{wxconnectiononadvise} member to be called. Returns true if successful. -\membersection{wxConnection::Execute}\label{wxddeconnectionexecute} +\membersection{wxConnection::Execute}\label{wxconnectionexecute} \func{bool}{Execute}{\param{char* }{data}, \param{int}{ size = -1}, \param{wxIPCFormat}{ format = wxCF\_TEXT}} Called by the client application to execute a command on the server. Can also be used to transfer arbitrary data to the server -(similar to \helpref{wxConnection::Poke}{wxddeconnectionpoke} in -that respect). Causes the server connection's \helpref{wxConnection::OnExecute}{wxddeconnectiononexecute} +(similar to \helpref{wxConnection::Poke}{wxconnectionpoke} in +that respect). Causes the server connection's \helpref{wxConnection::OnExecute}{wxconnectiononexecute} member to be called. Returns true if successful. -\membersection{wxConnection::Disconnect} +\membersection{wxConnection::Disconnect}\label{wxconnectiondisconnect} \func{bool}{Disconnect}{\void} Called by the client or server application to disconnect from the -other program; it causes the \helpref{wxConnection::OnDisconnect}{wxddeconnectionondisconnect} +other program; it causes the \helpref{wxConnection::OnDisconnect}{wxconnectionondisconnect} message to be sent to the corresponding connection object in the other program. Returns true if successful or already disconnected. The application that calls {\bf Disconnect} must explicitly delete its side of the connection. -\membersection{wxConnection::OnAdvise}\label{wxddeconnectiononadvise} +\membersection{wxConnection::OnAdvise}\label{wxconnectiononadvise} \func{virtual bool}{OnAdvise}{\param{const wxString\& }{topic}, \param{const wxString\& }{item}, \param{char* }{data}, \param{int}{ size}, \param{wxIPCFormat}{ format}} Message sent to the client application when the server notifies it of a change in the data associated with the given item, using -\helpref{Advise}{wxddeconnectionadvise}. +\helpref{Advise}{wxconnectionadvise}. -\membersection{wxConnection::OnDisconnect}\label{wxddeconnectionondisconnect} +\membersection{wxConnection::OnDisconnect}\label{wxconnectionondisconnect} \func{virtual bool}{OnDisconnect}{\void} @@ -131,33 +131,33 @@ applications should generally override {\bf OnDisconnect} (finally calling the inherited method as well) so that they know the connection object is no longer available. -\membersection{wxConnection::OnExecute}\label{wxddeconnectiononexecute} +\membersection{wxConnection::OnExecute}\label{wxconnectiononexecute} \func{virtual bool}{OnExecute}{\param{const wxString\& }{topic}, \param{char* }{data}, \param{int}{ size}, \param{wxIPCFormat}{ format}} Message sent to the server application when the client notifies -it to execute the given data, using \helpref{Execute}{wxddeconnectionexecute}. +it to execute the given data, using \helpref{Execute}{wxconnectionexecute}. Note that there is no item associated with this message. -\membersection{wxConnection::OnPoke}\label{wxddeconnectiononpoke} +\membersection{wxConnection::OnPoke}\label{wxconnectiononpoke} \func{virtual bool}{OnPoke}{\param{const wxString\& }{topic}, \param{const wxString\& }{item}, \param{char* }{data}, \param{int}{ size}, \param{wxIPCFormat}{ format}} Message sent to the server application when the client notifies it to accept the given data. -\membersection{wxConnection::OnRequest}\label{wxddeconnectiononrequest} +\membersection{wxConnection::OnRequest}\label{wxconnectiononrequest} -\func{virtual char*}{OnRequest}{\param{const wxString\& }{topic}, \param{const wxString\& }{item}, \param{int *}{size}, \param{wxIPCFormat}{ format}} +\func{virtual const char*}{OnRequest}{\param{const wxString\& }{topic}, \param{const wxString\& }{item}, \param{int *}{size}, \param{wxIPCFormat}{ format}} Message sent to the server application when the client calls -\helpref{wxConnection::Request}{wxddeconnectionrequest}. The -server's \helpref{OnRequest}{wxddeconnectiononrequest} method +\helpref{wxConnection::Request}{wxconnectionrequest}. The +server's \helpref{OnRequest}{wxconnectiononrequest} method should respond by returning a character string, or NULL to indicate no data, and setting *size. The character string must of course persist after the call returns. -\membersection{wxConnection::OnStartAdvise}\label{wxddeconnectiononstartadvise} +\membersection{wxConnection::OnStartAdvise}\label{wxconnectiononstartadvise} \func{virtual bool}{OnStartAdvise}{\param{const wxString\& }{topic}, \param{const wxString\& }{item}} @@ -165,7 +165,7 @@ Message sent to the server application by the client, when the client wishes to start an `advise loop' for the given topic and item. The server can refuse to participate by returning false. -\membersection{wxConnection::OnStopAdvise}\label{wxddeconnectiononstopadvise} +\membersection{wxConnection::OnStopAdvise}\label{wxconnectiononstopadvise} \func{virtual bool}{OnStopAdvise}{\param{const wxString\& }{topic}, \param{const wxString\& }{item}} @@ -174,24 +174,24 @@ wishes to stop an `advise loop' for the given topic and item. The server can refuse to stop the advise loop by returning false, although this doesn't have much meaning in practice. -\membersection{wxConnection::Poke}\label{wxddeconnectionpoke} +\membersection{wxConnection::Poke}\label{wxconnectionpoke} -\func{bool}{Poke}{\param{const wxString\& }{item}, \param{char* }{data}, \param{int}{ size = -1}, \param{wxIPCFormat}{ format = wxCF\_TEXT}} +\func{bool}{Poke}{\param{const wxString\& }{item}, \param{const char* }{data}, \param{int}{ size = -1}, \param{wxIPCFormat}{ format = wxCF\_TEXT}} Called by the client application to poke data into the server. Can be used to transfer arbitrary data to the server. Causes the -server connection's \helpref{wxConnection::OnPoke}{wxddeconnectiononpoke} member to +server connection's \helpref{wxConnection::OnPoke}{wxconnectiononpoke} member to be called. If size is -1 the size is computed from the string length of data. Returns true if successful. -\membersection{wxConnection::Request}\label{wxddeconnectionrequest} +\membersection{wxConnection::Request}\label{wxconnectionrequest} \func{char*}{Request}{\param{const wxString\& }{item}, \param{int *}{size}, \param{wxIPCFormat}{ format = wxIPC\_TEXT}} Called by the client application to request data from the server. -Causes the server connection's \helpref{wxConnection::OnRequest}{wxddeconnectiononrequest} +Causes the server connection's \helpref{wxConnection::OnRequest}{wxconnectiononrequest} member to be called. Size may be NULL or a pointer to a variable to receive the size of the requested item. @@ -199,22 +199,22 @@ Returns a character string (actually a pointer to the connection's buffer) if successful, NULL otherwise. This buffer does not need to be deleted. -\membersection{wxConnection::StartAdvise}\label{wxddeconnectionstartadvise} +\membersection{wxConnection::StartAdvise}\label{wxconnectionstartadvise} \func{bool}{StartAdvise}{\param{const wxString\& }{item}} Called by the client application to ask if an advise loop can be started with the server. Causes the server connection's -\helpref{wxConnection::OnStartAdvise}{wxddeconnectiononstartadvise}\rtfsp +\helpref{wxConnection::OnStartAdvise}{wxconnectiononstartadvise}\rtfsp member to be called. Returns true if the server okays it, false otherwise. -\membersection{wxConnection::StopAdvise}\label{wxddeconnectionstopadvise} +\membersection{wxConnection::StopAdvise}\label{wxconnectionstopadvise} \func{bool}{StopAdvise}{\param{const wxString\& }{item}} Called by the client application to ask if an advise loop can be -stopped. Causes the server connection's \helpref{wxConnection::OnStopAdvise}{wxddeconnectiononstopadvise} +stopped. Causes the server connection's \helpref{wxConnection::OnStopAdvise}{wxconnectiononstopadvise} member to be called. Returns true if the server okays it, false otherwise.