]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/ipcconn.tex
added HasHandlerForPath() (modified patch 1514524)
[wxWidgets.git] / docs / latex / wx / ipcconn.tex
index 44e2fb6d7cf2483fcdcc16349dc0f90035c9d0d3..0463305be0bdd5277e8d3bad7bfed28ea3dc5e7a 100644 (file)
@@ -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
 
 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
 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}
 
 
 \wxheading{See also}
 
-\helpref{wxClient}{wxddeclient}, \helpref{wxServer}{wxddeserver},
+\helpref{wxClient}{wxclient}, \helpref{wxServer}{wxserver},
 \helpref{Interprocess communications overview}{ipcoverview}
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
 \helpref{Interprocess communications overview}{ipcoverview}
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
-\membersection{wxConnection::wxConnection}
+\membersection{wxConnection::wxConnection}\label{wxconnectionctor}
 
 \func{}{wxConnection}{\void}
 
 
 \func{}{wxConnection}{\void}
 
@@ -70,8 +70,8 @@ object is to be derived from wxConnection, then the constructor
 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
 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.
 
 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.
 
 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}}
 
 Called by the server application to advise the client of a change
 in the data associated with the given item. Causes the client
 
 \func{bool}{Advise}{\param{const wxString\& }{item}, \param{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.
 
 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
 
 \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.
 
 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
 
 \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.
 
 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
 
 \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}
 
 
 \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.
 
 (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
 
 \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.
 
 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.
 
 
 \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}}
 
 Message sent to the server application when the client calls 
 
 \func{virtual 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.
 
 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}}
 
 
 \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.
 
 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}}
 
 
 \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.
 
 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}}
 
 Called by the client application to poke data into the server.
 Can be used to transfer arbitrary data to the server. Causes the
 
 \func{bool}{Poke}{\param{const wxString\& }{item}, \param{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.
 
 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.
 
 \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.
 
 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.
 
 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 
 
 \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.
 
 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
 
 \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.
 
 member to be called. Returns true if the server okays it, false
 otherwise.