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
.