1998-05-20 14:12:05 +00:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Name: dde.h
|
|
|
|
// Purpose: DDE class
|
|
|
|
// Author: Julian Smart
|
|
|
|
// Modified by:
|
|
|
|
// Created: 01/02/97
|
|
|
|
// RCS-ID: $Id$
|
1998-08-07 23:52:45 +00:00
|
|
|
// Copyright: (c) Julian Smart
|
|
|
|
// Licence: wxWindows licence
|
1998-05-20 14:12:05 +00:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
1998-08-07 23:52:45 +00:00
|
|
|
#ifndef _WX_DDE_H_
|
|
|
|
#define _WX_DDE_H_
|
1998-05-20 14:12:05 +00:00
|
|
|
|
|
|
|
#ifdef __GNUG__
|
|
|
|
#pragma interface "dde.h"
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#include "wx/ipcbase.h"
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Mini-DDE implementation
|
|
|
|
|
|
|
|
Most transactions involve a topic name and an item name (choose these
|
|
|
|
as befits your application).
|
|
|
|
|
|
|
|
A client can:
|
|
|
|
|
|
|
|
- ask the server to execute commands (data) associated with a topic
|
|
|
|
- request data from server by topic and item
|
|
|
|
- poke data into the server
|
|
|
|
- ask the server to start an advice loop on topic/item
|
|
|
|
- ask the server to stop an advice loop
|
|
|
|
|
|
|
|
A server can:
|
|
|
|
|
|
|
|
- respond to execute, request, poke and advice start/stop
|
|
|
|
- send advise data to client
|
|
|
|
|
|
|
|
Note that this limits the server in the ways it can send data to the
|
|
|
|
client, i.e. it can't send unsolicited information.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
class WXDLLEXPORT wxDDEServer;
|
|
|
|
class WXDLLEXPORT wxDDEClient;
|
|
|
|
|
|
|
|
class WXDLLEXPORT wxDDEConnection: public wxConnectionBase
|
|
|
|
{
|
|
|
|
DECLARE_DYNAMIC_CLASS(wxDDEConnection)
|
1998-07-28 08:12:20 +00:00
|
|
|
public:
|
1998-05-20 14:12:05 +00:00
|
|
|
wxDDEConnection(char *buffer, int size);
|
|
|
|
wxDDEConnection(void);
|
|
|
|
~wxDDEConnection(void);
|
|
|
|
|
|
|
|
// Calls that CLIENT can make
|
1999-10-04 20:15:38 +00:00
|
|
|
virtual bool Execute(const wxChar *data, int size = -1, wxIPCFormat format = wxIPC_TEXT);
|
1999-01-19 16:33:16 +00:00
|
|
|
virtual char *Request(const wxString& item, int *size = NULL, wxIPCFormat format = wxIPC_TEXT);
|
1999-06-10 18:12:13 +00:00
|
|
|
virtual bool Poke(const wxString& item, wxChar *data, int size = -1, wxIPCFormat format = wxIPC_TEXT);
|
1998-05-20 14:12:05 +00:00
|
|
|
virtual bool StartAdvise(const wxString& item);
|
|
|
|
virtual bool StopAdvise(const wxString& item);
|
|
|
|
|
|
|
|
// Calls that SERVER can make
|
1999-06-10 18:12:13 +00:00
|
|
|
virtual bool Advise(const wxString& item, wxChar *data, int size = -1, wxIPCFormat format = wxIPC_TEXT);
|
1998-05-20 14:12:05 +00:00
|
|
|
|
|
|
|
// Calls that both can make
|
|
|
|
virtual bool Disconnect(void);
|
|
|
|
|
|
|
|
// Default behaviour is to delete connection and return TRUE
|
|
|
|
virtual bool OnDisconnect(void);
|
1998-07-28 08:12:20 +00:00
|
|
|
|
|
|
|
public:
|
|
|
|
char* m_bufPtr;
|
|
|
|
wxString m_topicName;
|
|
|
|
int m_bufSize;
|
|
|
|
wxDDEServer* m_server;
|
|
|
|
wxDDEClient* m_client;
|
|
|
|
|
|
|
|
WXHCONV m_hConv;
|
1999-06-10 18:12:13 +00:00
|
|
|
wxChar* m_sendingData;
|
1998-07-28 08:12:20 +00:00
|
|
|
int m_dataSize;
|
1999-01-19 16:33:16 +00:00
|
|
|
wxIPCFormat m_dataType;
|
1998-05-20 14:12:05 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
class WXDLLEXPORT wxDDEServer: public wxServerBase
|
|
|
|
{
|
|
|
|
DECLARE_DYNAMIC_CLASS(wxDDEServer)
|
|
|
|
public:
|
|
|
|
|
|
|
|
wxDDEServer(void);
|
|
|
|
~wxDDEServer(void);
|
|
|
|
bool Create(const wxString& server_name); // Returns FALSE if can't create server (e.g. port
|
|
|
|
// number is already in use)
|
|
|
|
virtual wxConnectionBase *OnAcceptConnection(const wxString& topic);
|
|
|
|
|
|
|
|
////////////////////////////////////////////////////////////
|
|
|
|
// Implementation
|
|
|
|
|
|
|
|
// Find/delete wxDDEConnection corresponding to the HCONV
|
|
|
|
wxDDEConnection *FindConnection(WXHCONV conv);
|
|
|
|
bool DeleteConnection(WXHCONV conv);
|
1998-07-28 08:12:20 +00:00
|
|
|
inline wxString& GetServiceName(void) const { return (wxString&) m_serviceName; }
|
|
|
|
inline wxList& GetConnections(void) const { return (wxList&) m_connections; }
|
1998-05-20 14:12:05 +00:00
|
|
|
|
|
|
|
protected:
|
1998-07-28 08:12:20 +00:00
|
|
|
int m_lastError;
|
|
|
|
wxString m_serviceName;
|
|
|
|
wxList m_connections;
|
1998-05-20 14:12:05 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
class WXDLLEXPORT wxDDEClient: public wxClientBase
|
|
|
|
{
|
|
|
|
DECLARE_DYNAMIC_CLASS(wxDDEClient)
|
|
|
|
public:
|
|
|
|
wxDDEClient(void);
|
|
|
|
~wxDDEClient(void);
|
|
|
|
bool ValidHost(const wxString& host);
|
|
|
|
virtual wxConnectionBase *MakeConnection(const wxString& host, const wxString& server, const wxString& topic);
|
|
|
|
// Call this to make a connection.
|
|
|
|
// Returns NULL if cannot.
|
|
|
|
virtual wxConnectionBase *OnMakeConnection(void); // Tailor this to return own connection.
|
|
|
|
|
|
|
|
////////////////////////////////////////////////////////////
|
|
|
|
// Implementation
|
|
|
|
|
|
|
|
// Find/delete wxDDEConnection corresponding to the HCONV
|
|
|
|
wxDDEConnection *FindConnection(WXHCONV conv);
|
|
|
|
bool DeleteConnection(WXHCONV conv);
|
1998-07-28 08:12:20 +00:00
|
|
|
inline wxList& GetConnections(void) const { return (wxList&) m_connections; }
|
1998-05-20 14:12:05 +00:00
|
|
|
|
|
|
|
protected:
|
1998-07-28 08:12:20 +00:00
|
|
|
int m_lastError;
|
|
|
|
wxList m_connections;
|
1998-05-20 14:12:05 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
void WXDLLEXPORT wxDDEInitialize();
|
|
|
|
void WXDLLEXPORT wxDDECleanUp();
|
|
|
|
|
|
|
|
#endif
|
1998-08-07 23:52:45 +00:00
|
|
|
// _WX_DDE_H_
|