dde-advise-start* service topic item &key key function format datap type errorp connect-error-p new-conversation-p => result
A string or symbol.
A string or symbol.
A string or symbol.
An object.
A function name.
A clipboard format specifier.
A boolean.
A keyword.
A boolean.
A boolean.
The dde-advise-start*
function is similar to the dde-advise-start, and sets up an advise loop for the data item specified by item on a conversation recognizing the service / topic pair.
See dde-advise-start for information on the format , type , and datap arguments.
The argument key is used to identify this link. If specified as nil
(the default value), it defaults to the conversation. Multiple links are permitted on a conversation with the same item and format values, as long as their key values differ.
If the link is established, the return value result is t
. If the link could not be established, the behavior depends on the value of errorp . If errorp is t
(the default value), LispWorks signals an error. If it is nil
, the function returns nil
to indicate failure.
If the link is established, the function function will be called whenever the data changes. If function is nil
(the default value), the generic function dde-client-advise-data will be called.
The function specified by function should have a lambda list similar to the following:
key item data &key conversation &allow-other-keys
The arguments key and item identify the link. The argument data contains the new data for hot links; for warm links it is nil
.