docs/latex/wx/ddeservr.tex

   1 \section{\class{wxDDEServer}}\label{wxddeserver}
   2
   3 A wxDDEServer object represents the server part of a client-server DDE
   4 (Dynamic Data Exchange) conversation.
   5
   6 This DDE-based implementation is
   7 available on Windows only, but a platform-independent, socket-based version
   8 of this API is available using \helpref{wxTCPServer}{wxtcpserver}.
   9
  10 \wxheading{Derived from}
  11
  12 wxServerBase
  13
  14 \wxheading{Include files}
  15
  16 <wx/dde.h>
  17
  18 \wxheading{Library}
  19
  20 \helpref{wxBase}{librarieslist}
  21
  22 \wxheading{See also}
  23
  24 \helpref{wxDDEClient}{wxddeclient}, \helpref{wxDDEConnection}{wxddeconnection}, \helpref{IPC overview}{ipcoverview}
  25
  26 \latexignore{\rtfignore{\wxheading{Members}}}
  27
  28 \membersection{wxDDEServer::wxDDEServer}\label{wxddeserverctor}
  29
  30 \func{}{wxDDEServer}{\void}
  31
  32 Constructs a server object.
  33
  34 \membersection{wxDDEServer::Create}\label{wxddeservercreate}
  35
  36 \func{bool}{Create}{\param{const wxString\& }{service}}
  37
  38 Registers the server using the given service name. Under UNIX, the
  39 string must contain an integer id which is used as an Internet port
  40 number. false is returned if the call failed (for example, the port
  41 number is already in use).
  42
  43 \membersection{wxDDEServer::OnAcceptConnection}\label{wxddeserveronacceptconnection}
  44
  45 \func{virtual wxConnectionBase *}{OnAcceptConnection}{\param{const wxString\& }{topic}}
  46
  47 When a client calls {\bf MakeConnection}, the server receives the
  48 message and this member is called. The application should derive a
  49 member to intercept this message and return a connection object of
  50 either the standard wxDDEConnection type, or of a user-derived type. If the
  51 topic is ``STDIO'', the application may wish to refuse the connection.
  52 Under UNIX, when a server is created the OnAcceptConnection message is
  53 always sent for standard input and output, but in the context of DDE
  54 messages it doesn't make a lot of sense.
  55