corrected CodeWarrior project target names and generated application names

[wxWidgets.git] / docs / latex / wx / ddeconn.tex

diff --git a/docs/latex/wx/ddeconn.tex b/docs/latex/wx/ddeconn.tex
index d1486d7884e962f2b52b64b832110cf27167924c..0be17834bcf5997be9dbc424d5b4790ee3a6f79d 100644 (file)
--- a/docs/latex/wx/ddeconn.tex
+++ b/docs/latex/wx/ddeconn.tex
@@ -4,7 +4,7 @@ A wxDDEConnection object represents the connection between a client and a
 server. It can be created by making a connection using a\rtfsp
 \helpref{wxDDEClient}{wxddeclient} object, or by the acceptance of a connection by a\rtfsp
 \helpref{wxDDEServer}{wxddeserver} object. The bulk of a DDE (Dynamic Data Exchange)
 server. It can be created by making a connection using a\rtfsp
 \helpref{wxDDEClient}{wxddeclient} object, or by the acceptance of a connection by a\rtfsp
 \helpref{wxDDEServer}{wxddeserver} object. The bulk of a DDE (Dynamic Data Exchange)

-conversation (available in both Windows and UNIX) is controlled by
+conversation is controlled by

 calling members in a {\bf wxDDEConnection} object or by overriding its
 members.
 
 calling members in a {\bf wxDDEConnection} object or by overriding its
 members.
 


@@ -12,10 +12,47 @@ An application should normally derive a new connection class from
 wxDDEConnection, in order to override the communication event handlers
 to do something interesting.
 
 wxDDEConnection, in order to override the communication event handlers
 to do something interesting.
 

+This DDE-based implementation is available on Windows only,
+but a platform-independent, socket-based version
+of this API is available using \helpref{wxTCPConnection}{wxtcpconnection}.
+

 \wxheading{Derived from}
 
 \wxheading{Derived from}
 

+wxConnectionBase\\

 \helpref{wxObject}{wxobject}
 
 \helpref{wxObject}{wxobject}
 

+\wxheading{Include files}
+
+<wx/dde.h>
+
+\wxheading{Types}
+
+\index{wxIPCFormat}wxIPCFormat is defined as follows:
+
+\begin{verbatim}
+enum wxIPCFormat
+{
+  wxIPC_INVALID =          0,
+  wxIPC_TEXT =             1,  /* CF_TEXT */
+  wxIPC_BITMAP =           2,  /* CF_BITMAP */
+  wxIPC_METAFILE =         3,  /* CF_METAFILEPICT */
+  wxIPC_SYLK =             4,
+  wxIPC_DIF =              5,
+  wxIPC_TIFF =             6,
+  wxIPC_OEMTEXT =          7,  /* CF_OEMTEXT */
+  wxIPC_DIB =              8,  /* CF_DIB */
+  wxIPC_PALETTE =          9,
+  wxIPC_PENDATA =          10,
+  wxIPC_RIFF =             11,
+  wxIPC_WAVE =             12,
+  wxIPC_UNICODETEXT =      13,
+  wxIPC_ENHMETAFILE =      14,
+  wxIPC_FILENAME =         15, /* CF_HDROP */
+  wxIPC_LOCALE =           16,
+  wxIPC_PRIVATE =          20
+};
+\end{verbatim}
+

 \wxheading{See also}
 
 \helpref{wxDDEClient}{wxddeclient}, \helpref{wxDDEServer}{wxddeserver}, \helpref{Interprocess communications overview}{ipcoverview}
 \wxheading{See also}
 
 \helpref{wxDDEClient}{wxddeclient}, \helpref{wxDDEServer}{wxddeserver}, \helpref{Interprocess communications overview}{ipcoverview}


@@ -42,7 +79,7 @@ transactions.
 
 \membersection{wxDDEConnection::Advise}
 
 
 \membersection{wxDDEConnection::Advise}
 

-\func{bool}{Advise}{\param{const wxString\& }{item}, \param{char* }{data}, \param{int}{ size = -1}, \param{int}{ format = wxCF\_TEXT}}
+\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
 
 Called by the server application to advise the client of a change in
 the data associated with the given item. Causes the client


@@ -51,8 +88,7 @@ member to be called. Returns TRUE if successful.
 
 \membersection{wxDDEConnection::Execute}
 
 
 \membersection{wxDDEConnection::Execute}
 

-\func{bool}{Execute}{\param{char* }{data}, \param{int}{ size = -1},
-\param{int}{ format = wxCF\_TEXT}}
+\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
 
 Called by the client application to execute a command on the server. Can
 also be used to transfer arbitrary data to the server (similar


@@ -74,14 +110,14 @@ successful.
 
 \membersection{wxDDEConnection::OnAdvise}\label{wxddeconnectiononadvise}
 
 
 \membersection{wxDDEConnection::OnAdvise}\label{wxddeconnectiononadvise}
 

-\func{bool}{OnAdvise}{\param{const wxString\& }{topic}, \param{const wxString\& }{item}, \param{char* }{data}, \param{int}{ size}, \param{int}{ format}}
+\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.
 
 \membersection{wxDDEConnection::OnDisconnect}\label{wxddeconnectionondisconnect}
 
 
 Message sent to the client application when the server notifies it of a
 change in the data associated with the given item.
 
 \membersection{wxDDEConnection::OnDisconnect}\label{wxddeconnectionondisconnect}
 

-\func{bool}{OnDisconnect}{\void}
+\func{virtual bool}{OnDisconnect}{\void}

 
 Message sent to the client or server application when the other
 application notifies it to delete the connection. Default behaviour is
 
 Message sent to the client or server application when the other
 application notifies it to delete the connection. Default behaviour is


@@ -89,7 +125,7 @@ to delete the connection object.
 
 \membersection{wxDDEConnection::OnExecute}\label{wxddeconnectiononexecute}
 
 
 \membersection{wxDDEConnection::OnExecute}\label{wxddeconnectiononexecute}
 

-\func{bool}{OnExecute}{\param{const wxString\& }{topic}, \param{char* }{data}, \param{int}{ size}, \param{int}{ format}}
+\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. Note that there is no item associated with
 
 Message sent to the server application when the client notifies it to
 execute the given data. Note that there is no item associated with


@@ -97,14 +133,14 @@ this message.
 
 \membersection{wxDDEConnection::OnPoke}\label{wxddeconnectiononpoke}
 
 
 \membersection{wxDDEConnection::OnPoke}\label{wxddeconnectiononpoke}
 

-\func{bool}{OnPoke}{\param{const wxString\& }{topic}, \param{const wxString\& }{item}, \param{char* }{data}, \param{int}{ size}, \param{int}{ format}}
+\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{wxDDEConnection::OnRequest}\label{wxddeconnectiononrequest}
 
 
 Message sent to the server application when the client notifies it to
 accept the given data.
 
 \membersection{wxDDEConnection::OnRequest}\label{wxddeconnectiononrequest}
 

-\func{char*}{OnRequest}{\param{const wxString\& }{topic}, \param{const wxString\& }{item}, \param{int *}{size}, \param{int}{ format}}
+\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{wxDDEConnection::Request}{wxddeconnectionrequest}. The server
 
 Message sent to the server application when the client
 calls \helpref{wxDDEConnection::Request}{wxddeconnectionrequest}. The server


@@ -113,7 +149,7 @@ or NULL to indicate no data.
 
 \membersection{wxDDEConnection::OnStartAdvise}\label{wxddeconnectiononstartadvise}
 
 
 \membersection{wxDDEConnection::OnStartAdvise}\label{wxddeconnectiononstartadvise}
 

-\func{bool}{OnStartAdvise}{\param{const wxString\& }{topic}, \param{const wxString\& }{item}}
+\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
 
 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


@@ -121,7 +157,7 @@ server can refuse to participate by returning FALSE.
 
 \membersection{wxDDEConnection::OnStopAdvise}\label{wxddeconnectiononstopadvise}
 
 
 \membersection{wxDDEConnection::OnStopAdvise}\label{wxddeconnectiononstopadvise}
 

-\func{bool}{OnStopAdvise}{\param{const wxString\& }{topic}, \param{const wxString\& }{item}}
+\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
 
 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


@@ -130,7 +166,7 @@ this doesn't have much meaning in practice.
 
 \membersection{wxDDEConnection::Poke}\label{wxddeconnectionpoke}
 
 
 \membersection{wxDDEConnection::Poke}\label{wxddeconnectionpoke}
 

-\func{bool}{Poke}{\param{const wxString\& }{item}, \param{char* }{data}, \param{int}{ size = -1}, \param{int}{ format = wxCF\_TEXT}}
+\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
 
 Called by the client application to poke data into the server. Can be
 used to transfer arbitrary data to the server. Causes the server


@@ -139,7 +175,7 @@ to be called. Returns TRUE if successful.
 
 \membersection{wxDDEConnection::Request}\label{wxddeconnectionrequest}
 
 
 \membersection{wxDDEConnection::Request}\label{wxddeconnectionrequest}
 

-\func{char*}{Request}{\param{const wxString\& }{item}, \param{int *}{size}, \param{int}{ format = wxCF\_TEXT}}
+\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{wxDDEConnection::OnRequest}{wxddeconnectiononrequest} member to be called. Returns a
 
 Called by the client application to request data from the server. Causes
 the server connection's \helpref{wxDDEConnection::OnRequest}{wxddeconnectiononrequest} member to be called. Returns a