DdeServerManager public instance methods

addCallback:receiver:selector:clientData:

Adds a callback to one of the receiver's callback lists.

Generally speaking, a DdeServerManager expecting to interact with an application declares one or more callback lists as resources, and the application adds to these callback lists the callbacks that are invoked whenever the predefined callback conditions are met. Callback lists are resources, so that the application can set or change the function that is invoked.

Callbacks are not necessarily invoked in response to any event; a DdeServerManager can call the specified routines at any arbitrary point in its code, whenever it wants to provide a "hook" for application interaction. For example, all DdeServerManager objects provide a terminationCallback resource to enable applications to interpose a routine to be run when a DDE connection is broken.

This message adds a new callback to the end of the callback list. A callback is invoked as many times as it occurs in the callback list.

callbackName

The resource name of the callback list to which the callback is to be appended.

receiver

The object to send the callback message to.

selector

The three-parameter message selector to send.

clientData

An object to be passed to the receiver of the callback message as the clientData parameter when the callback is invoked, or nil.

 

addItem:topic:value:format:

Adds an item to the database.

item

A String identifying the name of the item.

topic

A String identifying the topic to which the item belongs.

value

The data that is named by item. If the format is 'String,' the value must be a Smalltalk String, otherwise it must be a ByteArray.

format

A String identifying the format of the data.

 

free

Frees any allocated resources. The DdeServerManager cannot be used at any time after this message is sent.

 

name

Answers a String that is the name of the receiver.

 

notifyClientOfSupportFor:

Notifies the client attempting to connect that the receiver supports the specified topic.

topicString

A String identifying the name of the topic.

 

removeAllCallbacks:

Deletes all callbacks from a callback list.

This message removes all the instance callback messages identified by the specified callback name, regardless of the value of the clientData associated with each message. This is in contrast to removeCallback:..., which removes the specified callback only if a specified clientData argument also matches.

callbackName

The resource name of the callback list from which the callback is to be removed.

 

removeCallback:receiver:selector:clientData:

Deletes a callback from a callback list.

This message removes a callback message identified by callbackName.

The callback is removed only if both the callbackName and clientData match a callback/data pair in the list. No warning message is generated if a callback to be removed fails to match a callback or clientData in the list. Use removeAllCallbacks:... if you want to remove a particular callback regardless of the value of its clientData.

callbackName

The resource name of the callback list from which the callback is to be deleted.

receiver

The object to match against the callback receiver in the callback list.

selector

The three-parameter message selector which is to be used to match against the callback in the callback list.

clientData

The object to match with the clientData object in the callback list entry.

 

removeItem:topic:format:

Removes an item from the database. Answers false if the item was not removed, or answers true if the item was removed.

item

A String identifying the name of the item.

topic

A String identifying the topic to which the item belongs.

format

A String identifying the format of the data.

Return value:

true

Item was removed.

false

Item was not in the database and could not be removed.

 

servers

Answers a set of DdeServers that are all the manager's current servers (that is, connections).

 

testMode

Answers a Boolean indicating the current test mode.

A Windows limitation prevents a DDE client from seeing servers provided from the same program (.exe).

If you need to see DDE servers created from the same image as the DDE client, set testMode to true. While testMode is true other clients cannot see the servers from this program (.exe).

Return value:

true

Test mode is on.

false

Test mode is off.

 

testMode:

Sets the current test mode. If the answer is true, it turns the test mode on. If false, it turns the test mode off.

A Windows limitation prevents a DDE client from seeing servers provided from the same program (.exe).

If you need to see local servers, set testMode to true. While testMode is true, other clients can not see the servers from this program (.exe).

timeout

Return an Integer indicating the number of milliseconds before a server times out.

 

timeout:

Sets the timeout value for any new connections.

numberOfMilliseconds

An Integer number of milliseconds.

 

updateItem:topic:value:format:

Updates an item in the database if it exists. Then updates any links to that item that any DDE clients might have. The links to the item are updated even if the item is not in the default database.

item

A String identifying the name of the item.

topic

A String identifying the topic to which the item belongs.

value

The data that is named by item. If the format is 'String,' then value must be a Smalltalk String, otherwise it must be a ByteArray.

format

A String identifying the format of the data.