All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

set-drop-object-supported-formats Function

Summary

Sets the list of formats for a drop object.

Package

capi

Signature

set-drop-object-supported-formats drop-object formats

Arguments
drop-object
A drop-object, as passed to the drop-callback.
formats
A list of format keywords.
Description

The function set-drop-object-supported-formats sets the list of formats that the drop object drop-object wants to receive.

The format :string can be used to receive a string from another application and the :filename-list format can be used to receive a list of filenames from another application such as the Macintosh Finder or the Windows Explorer.

GTK+ supports dragging of list of URIs. LispWorks uses a list of URIs to pass/receive the data with the format :filename-list, and also adds the format :uris. The behavior is as follows:

There is an example of :filename-list and :uris here:

(example-edit-file "capi/elements/gtk-filename-list-and-uris")

On Cocoa and GTK+ the :image format can be used to receive images. The value passed needs to be an image obtect.

Any other keyword in formats is assumed to be a private format that can only be used to receive objects from with the same Lisp image.

Notes

set-drop-object-supported-formats should only be called within a drop-callback. See simple-pane for information about drop callbacks.

Examples
(example-edit-file "capi/output-panes/drag-and-drop")
(example-edit-file "capi/choice/drag-and-drop")
(example-edit-file "capi/choice/list-panel-drag-images")
See also

drop-object-provides-format
simple-pane
17 Drag and Drop


CAPI User Guide and Reference Manual (Unix version) - 01 Dec 2021 19:32:42