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 . The argument item should be a string, or a symbol. If it is a symbol its print name is used.

The argument format should be one of the following:

• A DDE format specifier, consisting of either a standard clipboard format or a registered clipboard format.
• A string containing either the name of a standard clipboard format (without the CF_ prefix), or the name of a registered clipboard format.
• A symbol, in which case its print name is taken to specify the clipboard format.
• The keyword :text . This is the default value.

The keyword :text is treated specially. If supported by the server it uses the CF_UNICODETEXT clipboard format, otherwise it used the CF_TEXT format.

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 the type argument is ignored.

On success, this function returns t . On failure, the behavior depends on the value of the errorp argument. 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