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