Action called when a file is "dropped" into the control. When several files are dropped at once, the callback is called several times, once for each file.
If defined after the element is mapped then the attribute DROPFILESTARGET must be set to YES.
[Windows and GTK Only] (GTK 2.6)
int function(Ihandle *ih, const char* filename, int num, int x, int y); [in C] ih: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 dropped file.
num:
Number index of the dropped file. If several files
are dropped, num is the index of the dropped file 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 the processing of dropped files will be interrupted.