DropTarget - A library to support "Drop target" functionality

Environment: MSVC++6.0 SP3, Win98/2000/NT4(SP5)

Code Description

Purpose:

DropTarget adds a "Drop target" (Drag&Drop client) functionality to your C++ code

Implementation:

[Any files you need to import in your project are shown in Red, any code to be added is shown in Blue]

(1)
Add the class definition files
- DropFileArray.cpp / .h
- MyDropTarget.cpp / .h
to your project.

(2)
#include "MyDropTarget.h" to your main *.cpp file
(in case of this demo "DropTargetDlg.cpp".

(3)
Define a message that will be recieved by your application if files are dropped on it:

   
[DropTargetDlg.h:]
// message constant
#define WM_DROPACTION WM_APP+1
// message handler definition
LRESULT OnDropAction(WPARAM wParam = 0, LPARAM lParam = 0);

[DropTargetDlg.cpp:]
BEGIN_MESSAGE_MAP(CDropTargetDlg, CDialog)
  // [...]
  ON_MESSAGE(WM_DROPACTION, OnDropAction)
END_MESSAGE_MAP()

(4)
Add the following to your dialog's "OnInitDialog()"-member function

OleInitialize(NULL); BOOL br =
   m_DropTarget.Register(this);

(5)
Implement a message handler for drop action:

[DropTargetDlg.cpp:]
LRESULT CDropTargetDlg::OnDropAction(WPARAM wParam, LPARAM lParam)
{
// [...]
}  

(6)
Define a member variable for the new class instance

[DropTargetDlg.h:]
CMyDropTarget m_DropTarget;

Member functions:

Besides the existing inherited functions, MyDropTarget.cpp / .h overrides / implements the following member functions:

 // retrieve number of files dropped onto target. 0 if none
 int GetNumDroppedFiles(); 
   
 // get first (ASCII) name of dropped file
 char* GetFirstDroppedFileName(); 
   
 // get any (position iNum) name of dropped file
 char* GetDroppedFileName(int iNum=0); 
   
 // get wide char name of dropped file
 wchar_t* GetDroppedFileNameW(int iNum=0); 
   
 // get first wide char name of dropped file
 wchar_t* GetFirstDroppedFileNameW(); 
   
 // handle file dropping
 BOOL OnDrop( CWnd* pWnd, COleDataObject* pDataObject, 
                    DROPEFFECT dropEffect, CPoint point );

OnDrop() retrieves a struct containing a (wide char) list of dropped files via the COleDataObject-pointer. The list is then separated into single file names which are filled into an array derived from CArray in order no to limit the possible number of files that can be dropped onto the application.

Normal character set (Win3.X, 9X) and wide character sets (WinNT4 & W2K) are transparently supported via in-line conversion functions.

Example:

Download the attached DropTarget demonstration workspace

Final word:

I hope, you find the supplied code useful.
Please feel free to send comments to VolkerBartheld@reetcom.de

Downloads

DropTargetDemoExe.zip is a compiled executable of the demo application.
DropTargetDemo.zip is a MSVC++ V6 workspace of the demo application.
DropTargetSrc.zip are the complete sources to be added to your project for compilation with MSVC++ V6.0 (SP3) including all necessary libraries.

Download demo project executable
DropTargetDemoExe.zip - 6.065 kBytes

Download demo project workspace
DropTargetDemo.zip - 14.618 kBytes

Download demo project source
DropTargetSrc.zip - 3.800 kBytes