NAME

xv_decode_drop − decode drop event

SYNOPSIS

xv_decode_drop(ev, buffer, bsize)
Event ∗ev;
char ∗buffer;
unsigned int bsize;

DESCRIPTION

xv_decode_drop() decodes an ACTION_DRAG_COPY or ACTION_DRAG_MOVE event into the text being dragged, or an ACTION_DRAG_LOAD event into the name of a file being dragged.  At most bsize bytes, always including a terminating ascii nul, will be placed in buffer--if more are available they will be discarded.  However the function will return the actual number of bytes of data that were available so you can determine if data was lost.  A buffer length of SELN_BUFSIZE (defined in sel_svc.h) should be sufficient. 

DIAGNOSTICS

Returns -1 if unable to obtain selected object. 

BUGS

Filenames are relative to the machine doing the drag--they may be incorrect or meaningless on the machine receiving the drop.  Selections containing too many characters (~1850) will not transfer. 

Sun Release 4.1  —  Last change: 30 April 1990