removed useless spaces
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@51911 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
@@ -7,9 +7,9 @@
|
||||
/////////////////////////////////////////////////////////////////////////////
|
||||
|
||||
/*!
|
||||
|
||||
|
||||
@page ipc_overview Interprocess communication overview
|
||||
|
||||
|
||||
Classes: #wxServer,
|
||||
#wxConnection,
|
||||
#wxClient
|
||||
@@ -17,16 +17,16 @@
|
||||
interprocess communication and network programming. This section
|
||||
only discusses one family of classes -- the DDE-like protocol --
|
||||
but here's a list of other useful classes:
|
||||
|
||||
|
||||
|
||||
|
||||
#wxSocketEvent,
|
||||
#wxSocketBase,
|
||||
#wxSocketClient,
|
||||
#wxSocketServer: classes for the low-level TCP/IP API.
|
||||
#wxProtocol, #wxURL, #wxFTP, #wxHTTP: classes
|
||||
for programming popular Internet protocols.
|
||||
|
||||
|
||||
|
||||
|
||||
wxWidgets' DDE-like protocol is a high-level protocol based on
|
||||
Windows DDE. There are two implementations of this DDE-like
|
||||
protocol: one using real DDE running on Windows only, and another
|
||||
@@ -47,8 +47,8 @@
|
||||
equivalent wxTCP... and wxDDE... classes can be used in much the
|
||||
same way.
|
||||
Three classes are central to the DDE-like API:
|
||||
|
||||
|
||||
|
||||
|
||||
wxClient. This represents the client application, and is used
|
||||
only within a client program.
|
||||
wxServer. This represents the server application, and is used
|
||||
@@ -57,8 +57,8 @@
|
||||
client to the server - both the client and the server use an
|
||||
instance of this class, one per connection. Most DDE transactions
|
||||
operate on this object.
|
||||
|
||||
|
||||
|
||||
|
||||
Messages between applications are usually identified by three
|
||||
variables: connection object, topic name and item name. A data
|
||||
string is a fourth element of some messages. To create a
|
||||
@@ -82,8 +82,8 @@
|
||||
overriding virtual functions in your class derived from
|
||||
wxConnection allows you to handle the DDE messages.
|
||||
To create a working server, the programmer must:
|
||||
|
||||
|
||||
|
||||
|
||||
Derive a class from wxConnection, providing handlers for various messages sent to the server
|
||||
side of a wxConnection (e.g. OnExecute, OnRequest, OnPoke). Only
|
||||
the handlers actually required by the application need to be
|
||||
@@ -94,11 +94,11 @@
|
||||
derived connection class if the connection is accepted.
|
||||
Create an instance of your server object and call Create to
|
||||
activate it, giving it a service name.
|
||||
|
||||
|
||||
|
||||
|
||||
To create a working client, the programmer must:
|
||||
|
||||
|
||||
|
||||
|
||||
Derive a class from wxConnection, providing handlers for various
|
||||
messages sent to the client side of a wxConnection (e.g.
|
||||
OnAdvise). Only the handlers actually required by the application
|
||||
@@ -115,19 +115,19 @@
|
||||
a connection object of the derived class if the connection is
|
||||
successful.
|
||||
Use the wxConnection member functions to send messages to the server.
|
||||
|
||||
|
||||
|
||||
|
||||
@ref datatransfer_overview
|
||||
#Examples
|
||||
@ref ddedetails_overview
|
||||
|
||||
|
||||
|
||||
|
||||
@section datatransfer Data transfer
|
||||
|
||||
|
||||
These are the ways that data can be transferred from one
|
||||
application to another. These are methods of wxConnection.
|
||||
|
||||
|
||||
|
||||
|
||||
@b Execute: the client calls the server with a data string representing
|
||||
a command to be executed. This succeeds or fails, depending on the
|
||||
server's willingness to answer. If the client wants to find the result
|
||||
@@ -143,22 +143,22 @@
|
||||
@b Advise: The client asks to be advised of any change in data
|
||||
associated with a particular item. If the server agrees, the server will
|
||||
send an OnAdvise message to the client along with the item and data.
|
||||
|
||||
|
||||
|
||||
|
||||
The default data type is wxCF_TEXT (ASCII text), and the default data
|
||||
size is the length of the null-terminated string. Windows-specific data
|
||||
types could also be used on the PC.
|
||||
|
||||
|
||||
@section ipcexamples Examples
|
||||
|
||||
|
||||
See the sample programs @e server and @e client in the IPC
|
||||
samples directory. Run the server, then the client. This demonstrates
|
||||
using the Execute, Request, and Poke commands from the client, together
|
||||
with an Advise loop: selecting an item in the server list box causes
|
||||
that item to be highlighted in the client list box.
|
||||
|
||||
|
||||
@section ddedetails More DDE details
|
||||
|
||||
|
||||
A wxClient object initiates the client part of a client-server
|
||||
DDE-like (Dynamic Data Exchange) conversation (available in both
|
||||
Windows and Unix).
|
||||
@@ -171,7 +171,7 @@
|
||||
member can return a wxConnection of the required class, when a
|
||||
connection is made.
|
||||
For example:
|
||||
|
||||
|
||||
@code
|
||||
class MyConnection: public wxConnection {
|
||||
public:
|
||||
@@ -180,14 +180,14 @@
|
||||
bool OnAdvise(const wxString& topic, const wxString& item, char *data, int size, wxIPCFormat format)
|
||||
{ wxMessageBox(topic, data); }
|
||||
};
|
||||
|
||||
|
||||
class MyClient: public wxClient {
|
||||
public:
|
||||
MyClient(void) {}
|
||||
wxConnectionBase *OnMakeConnection(void) { return new MyConnection; }
|
||||
};
|
||||
@endcode
|
||||
|
||||
|
||||
Here, @b MyConnection will respond to
|
||||
#OnAdvise messages sent by the
|
||||
server by displaying a message box.
|
||||
@@ -201,16 +201,16 @@
|
||||
request for a connection is accepted, and the client then
|
||||
requests an @e Advise loop from the server (an Advise loop is
|
||||
where the server calls the client when data has changed).
|
||||
|
||||
|
||||
@code
|
||||
wxString server = "4242";
|
||||
wxString hostName;
|
||||
wxGetHostName(hostName);
|
||||
|
||||
|
||||
// Create a new client
|
||||
MyClient *client = new MyClient;
|
||||
connection = (MyConnection *)client-MakeConnection(hostName, server, "IPC TEST");
|
||||
|
||||
|
||||
if (!connection)
|
||||
{
|
||||
wxMessageBox("Failed to make connection to server", "Client Demo Error");
|
||||
@@ -218,7 +218,7 @@
|
||||
}
|
||||
connection-StartAdvise("Item");
|
||||
@endcode
|
||||
|
||||
|
||||
*/
|
||||
|
||||
|
||||
|
||||
|
||||
|
Reference in New Issue
Block a user