- 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.