wxddeclient

a wxddeclient object represents the client part of a client-server dde (dynamic data exchange) conversation.

to create a client which can communicate with a suitable server, you need to derive a class from wxddeconnection and another from wxddeclient. the custom wxddeconnection class will intercept communications in a 'conversation' with a server, and the custom wxddeserver is required so that a user-overridden wxddeclient::onmakeconnection member can return a wxddeconnection of the required class, when a connection is made.

this dde-based implementation is available on windows only, but a platform-independent, socket-based version of this api is available using wxtcpclient.

derived from

wxclientbase
wxobject

include files

members

wxddeclient::wxddeclient
wxddeclient::makeconnection
wxddeclient::onmakeconnection
wxddeclient::validhost

wxddeclient::wxddeclient

wxddeclient()

constructs a client object.

wxddeclient::makeconnection

wxconnectionbase * makeconnection(const wxstring& host, const wxstring& service, const wxstring& topic)

tries to make a connection with a server specified by the host (machine name under unix, ignored under windows), service name (must contain an integer port number under unix), and topic string. if the server allows a connection, a wxddeconnection object will be returned. the type of wxddeconnection returned can be altered by overriding the wxddeclient::onmakeconnection member to return your own derived connection object.

wxddeclient::onmakeconnection

wxconnectionbase * onmakeconnection()

the type of wxddeconnection returned from a wxddeclient::makeconnection call can be altered by deriving the onmakeconnection member to return your own derived connection object. by default, a wxddeconnection object is returned.

the advantage of deriving your own connection class is that it will enable you to intercept messages initiated by the server, such as wxddeconnection::onadvise. you may also want to store application-specific data in instances of the new class.

wxddeclient::validhost

bool validhost(const wxstring& host)

returns true if this is a valid host name, false otherwise. this always returns true under ms windows.