-\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
\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}
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}{wxddeserveronacceptconnection}\rtfsp
-and/or \helpref{wxClient::OnMakeConnection}{wxddeclientonmakeconnection}
+connection object, the \helpref{wxServer::OnAcceptConnection}{wxserveronacceptconnection}\rtfsp
+and/or \helpref{wxClient::OnMakeConnection}{wxclientonmakeconnection}
members should be replaced by functions which construct the new
connection object.
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
-to be called. Returns TRUE if successful.
+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}
-member to be called. Returns TRUE if successful.
+(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.
+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}
(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}}
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.
+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}}
Message sent to the server application by the client, when the client
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
+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.
+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.
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
-member to be called. Returns TRUE if the server okays it, FALSE
+\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}
-member to be called. Returns TRUE if the server okays it, FALSE
+stopped. Causes the server connection's \helpref{wxConnection::OnStopAdvise}{wxconnectiononstopadvise}
+member to be called. Returns true if the server okays it, false
otherwise.
projects / wxWidgets.git / blobdiff