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.

If defined after the element is mapped then the attribute DRAGDROP must be set to YES.

[Windows and GTK Only] (GTK 2.6)

Callback

int function(Ihandle *ih, const char* filename, int num, int x, int y); [in C]
elem:dropfiles_cb(filename: string; num, x, y: number) -> (ret: number) [in Lua]

ih: identifier of the element that activated the event.
filename: Name of the dragged file.
num: Number of the dragged file. If several files are dragged, num counts the number of dragged files starting from "total-1" to "0".
x: X coordinate of the point where the user released the mouse button.
y: Y coordinate of the point where the user released the mouse button.

Returns: If IUP_IGNORE is returned the callback will NOT be called for the next dropped files, and processing of dropped files will be interrupted.

Affects

IupDialog, IupCanvas, IupGLCanvas, IupText, IupList