TPJFormDropFiles

Project: Drop Files Components.

Unit: PJDropFiles.

Applies to: ~>5.0

This non-visual component catches all WM_DROPFILES messages that are received by the form on which it is placed. The component therefore intercepts files dragged from Windows Explorer and dropped anywhere on the form, including the non-client areas. Use TPJFormDropFiles whenever you just need to catch files anywhere on the main window without bothering about which particular control the files are dropped on.

Methods

TPJFormDropFiles defines no new methods.

Properties

Only those properties added or modified by TPJFormDropFiles are listed here. All other inherited properties are omitted.

Property	Description
Count	This read-only property returns the number of files dropped on the form.
DropControl	This read only property references any control on the form that the files were dropped on.
DropPoint	This read only property gives the mouse coordinates where the files were dropped.
Enabled	Determines whether dropped files are handled or ignored.
FileName	The name of a file dropped on the form.
Files	The names of the most recent files dropped on the form.
Filter	References a file filter component used to filter the names of dropped files.
ForegroundOnDrop	Causes the form to be brought to the front when files are dropped.
IsFolder	Tells whether each of the dropped files is a folder or a file.
Options	Determines how the dropped files are processed and which files are stored in the Files property.

Events

Event	Description
OnBeforeDrop	Event that occurs just before files dropped on the form are processed.
OnDropFiles	Event that occurs when files are dropped on the form.
OnFileFilter	Event that occurs for each file and folder processed and allows for custom filtering of files.