EnableDragAndDrop

int EnableDragAndDrop (int panelHandle);

Purpose

This function enables traditional Windows file Drag–And–Drop notification for the specified panel. After calling this function, the panel's standard callback function will be passed an event EVENT_FILESDROPPED whenever files are dropped onto the panel from the Windows explorer shell.

The eventData1 parameter will be an array of strings indicating the received files. This scheme follows exactly that used by MultiFileSelectPopup –– see its Function Panel for more details.

eventData2 will be a pointer to a CVI Point structure indicating the position at which the files were dropped, relative to the top–left of the panel.

Note  The panel's ATTR_CALLBACK_DATA pointer will be passed to the panel callback with the EVENT_FILESDROPPED event.
Note  This function should not be called for a CVI Child panel –– Child panels will respond to Drag–And–Drop notifications as long as their Parent panels do.

Parameters

Input
Name Type Description
panelHandle integer The handle of the CVI panel for which Drag–And–Drop notification should be enabled.

Return Value

Name Type Description
status integer The status code that the function returns.

0 indicates success.

A negative value indicates an error.

This function may return a Programmer's Toolbox or UI Library error–code. Call GetGeneralErrorString to obtain a text description of the error.