All Manuals > CAPI User Guide > 16 Drag and Drop > 16.2 Dragging


16.2.3 Data formats


Receives a string, potentially from another application. Is also understood by some other panes that expect text.


Receives an image on Cocoa and GTK+. The value passed should be a gp:image . See Working with images for more information about images.When supplying an image for dragging (that is, including :image image in the plist argument of drag-pane-object or in the plist that is returned from the drop-callback ), the dragging mechanism frees the image (as by gp:free-image ) when it finishes with it (which will be at some indeterminate time later). If you need to pass an image which you want to use later, you should make a copy of it by gp:make-sub-image .

When receiving an image (by calling drop-object-get-object with :image ), the received image should also be freed when you finish with it. However, it will be freed automatically when the pane supplied to drop-object-get-object is destroyed, so you do not need to free it explictly if freeing can wait (which is probably true in most cases).

See the example in


Receives a list of files. Is understood by other applications such as the Mac OS X Finder and Windows Explorer.

You can also use private formats, named by arbitrary keywords, which will work only in the same Lisp image.

CAPI User Guide (Windows version) - 30 Aug 2011