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