IUP_K_ANY

IUP - Portable User Interface

DROPFILES_CB

Action called when a file is "dragged" to the application. When several files are dragged, the callback is called several times, once for each file.

Callback

int function(Ihandle *self, char* filename, int numFile, int posx, int posy); [in C]
elem:dropfiles(filename: string; numFile, posx, posy: number) -> (ret: number) [in IupLua3]
elem:dropfiles_cb(filename: string; numFile, posx, posy: number) -> (ret: number) [in IupLua5]

self: Indicator of the element that received the file drop.
filename: Name of the dragged file.
numFile: Number of the dragged file. If several files are dragged, numFile counts the number of dragged files up to zero.
posx: X coordinate of the point where the user released the mouse button.
posy: Y coordinate of the point where the user released the mouse button.

The callback must return IUP_DEFAULT to be called again for each of the dragged files. Returning IUP_IGNORE, the process is interrupted.

Notes

The callback must be set before the element is mapped.

Windows Only, not available in Motif.

Affects

IupDialog, IupCanvas