1\section{\class{wxDDEClient}}\label{wxddeclient} 2 3A wxDDEClient object represents the client part of a client-server DDE 4(Dynamic Data Exchange) conversation. 5 6To create a client which can communicate with a suitable server, 7you need to derive a class from wxDDEConnection and another from wxDDEClient. 8The custom wxDDEConnection class will intercept communications in 9a `conversation' with a server, and the custom wxDDEServer is required 10so that a user-overridden \helpref{wxDDEClient::OnMakeConnection}{wxddeclientonmakeconnection} member can return 11a wxDDEConnection of the required class, when a connection is made. 12 13This DDE-based implementation is 14available on Windows only, but a platform-independent, socket-based version 15of this API is available using \helpref{wxTCPClient}{wxtcpclient}. 16 17\wxheading{Derived from} 18 19wxClientBase\\ 20\helpref{wxObject}{wxobject} 21 22\wxheading{Include files} 23 24<wx/dde.h> 25 26\wxheading{See also} 27 28\helpref{wxDDEServer}{wxddeserver}, \helpref{wxDDEConnection}{wxddeconnection}, 29\helpref{Interprocess communications overview}{ipcoverview} 30 31\latexignore{\rtfignore{\wxheading{Members}}} 32 33\membersection{wxDDEClient::wxDDEClient}\label{wxddeclientctor} 34 35\func{}{wxDDEClient}{\void} 36 37Constructs a client object. 38 39\membersection{wxDDEClient::MakeConnection}\label{wxddeclientmakeconnection} 40 41\func{wxConnectionBase *}{MakeConnection}{\param{const wxString\& }{host}, \param{const wxString\& }{service}, \param{const wxString\& }{topic}} 42 43Tries to make a connection with a server specified by the host 44(machine name under UNIX, ignored under Windows), service name (must 45contain an integer port number under UNIX), and topic string. If the 46server allows a connection, a wxDDEConnection object will be returned. 47The type of wxDDEConnection returned can be altered by overriding 48the \helpref{wxDDEClient::OnMakeConnection}{wxddeclientonmakeconnection} member to return your own 49derived connection object. 50 51\membersection{wxDDEClient::OnMakeConnection}\label{wxddeclientonmakeconnection} 52 53\func{wxConnectionBase *}{OnMakeConnection}{\void} 54 55The type of \helpref{wxDDEConnection}{wxddeconnection} returned from a \helpref{wxDDEClient::MakeConnection}{wxddeclientmakeconnection} call can 56be altered by deriving the {\bf OnMakeConnection} member to return your 57own derived connection object. By default, a wxDDEConnection 58object is returned. 59 60The advantage of deriving your own connection class is that it will 61enable you to intercept messages initiated by the server, such 62as \helpref{wxDDEConnection::OnAdvise}{wxconnectiononadvise}. You may also want to 63store application-specific data in instances of the new class. 64 65\membersection{wxDDEClient::ValidHost}\label{wxddeclientvalidhost} 66 67\func{bool}{ValidHost}{\param{const wxString\& }{host}} 68 69Returns \true if this is a valid host name, \false otherwise. This always 70returns \true under MS Windows. 71 72