All Manuals > LispWorks® User Guide and Reference Manual > 50 The DDE client interface

dde-poke Function

Summary

Issues a poke transaction on a conversation, to set the value of a specified item.

Package

win32

Signature

dde-poke conversation item data &key format type errorp => result

Arguments
conversation
A conversation object.
item
A string or symbol.
data
A string.
format
A clipboard format specifier.
type
A keyword.
errorp
A boolean.
Values
result
A boolean.
Description

The function dde-poke issues a poke transaction on conversation to set the value of the item specified by item to the value specified by data. item should be a string, or a symbol. If it is a symbol its print name is used.

format should be one of the following:

For text transactions, the default value of type indicates that data is a Lisp string to be used. If type is :string-list, then data is taken to be a list of strings, and is sent as a tab-separated string.

Alternatively, data can be a clipboard-item structure, containing a foreign pointer to the data to send and the length of the data. In this case type is ignored.

On success, this function returns t. On failure, the behavior depends on errorp. If errorp is t (the default value), LispWorks signals an error. If it is nil, the function returns nil to indicate failure.

See also

dde-item
dde-request


LispWorks® User Guide and Reference Manual - 01 Dec 2021 19:31:09