Drop Files Components
Information Sheet

Contents

» Contents

Overview

Two components are provided that enable applications to support Windows Explorer file drag and drop. The components are:

Key features of these components are:

Help file

An OpenHelp compatible help file is included that integrates with Delphi 3 to 7. The help file does not integrate with Delphi 2005 and later, but can be used as a stand-alone help file with some loss of functionality. An a-link keyword file is supplied for use with Delphi 6 and 7.

Demo programs

The source code for two demo programs is included. Details are:

  1. The main demo program exercises all three drop files components and the filter components. This demo compiles with all the compilers supported by the components.
  2. A program that demonstrates how to use TPJCtrlDropFiles with frames. This demo requires Delphi 5 or later to compile, since frames are not supported in Delphi 3 or 4.

» Contents

Compatibility

The Drop Files Components compile with Delphi 3 and later. They have been tested with Delphi 3, 4, 6, 7 and 2006.

» Contents

Installation

The Drop Files Components, their documentation and the demo program are supplied in a zip file. Before installing you need to extract all the files from the zip file, preserving the directory structure. The following files will be extracted:

You can now proceed to install the components and property editor using the emphasised files above. Installation methods vary between Delphi versions, so follow the instructions that apply to your version below. Note that $(DELPHI) represents the path where the appropriate version of Delphi was installed. Similarly $(BDS) refers to the installation path of a version of the Borland Development System.

Installation with Delphi 2005 & 2006

The components must be installed into a Delphi Win32 design package. It is assumed that you will be installing into an existing package. You may decide to install into the "user" package: $(BDS)\Lib\dclusr.dpk.

  1. Decide upon a suitable location into which to install the components. This may be a subdirectory of your Borland Studio Projects or $(BDS)\lib folders.
  2. Copy PJDropFiles.pas, PJDropFiles.dcr, PJDropFilesDsgn.pas and PJDropFilesDsgn.dfm to the chosen installation folder.
  3. Start the Development System (selecting the Delphi Win32 personality if appropriate) then:
  4. If you wish you can now delete PJDropFiles.pas and PJDropFilesDsgn.pas from the chosen installation folder.
  5. The supplied help file cannot be integrated with the IDE's help system. However it can be used independently of the IDE, albeit with reduced functionality.
  6. The demo programs can be loaded into Delphi and compiled and run as required.

Installation with Delphi 3 to 7

The components must be installed into a design package. It is assumed that you will be installing into an existing package. You may wish to use the "user" package named dclusr.dpk or dclusrXX.dpk (where XX is a version number). This package can be found in $(DELPHI)\Lib.

  1. Decide upon a suitable location into which to install the components. This may be a subdirectory of your $(DELPHI)\lib folder.
  2. Copy PJDropFiles.pas, PJDropFiles.dcr, PJDropFilesDsgn.pas and PJDropFilesDsgn.dfm to the chosen installation folder.
  3. Start Delphi then:
  4. If you wish you can now delete PJDropFiles.pas and PJDropFilesDsgn.pas from the chosen installation folder.
  5. The provided help file can be integrated with the IDE's OpenHelp system. Delphi 6 and 7 also require the use of the supplied .als file. The simplest way to install help is to use my Component Help Installer Expert (v2.2.1 or later). If you prefer to install manually, this article explains the process.
  6. The demo programs can be loaded into Delphi and compiled and run as required. The frame demo requires Delphi 5 and higher.

» Contents

Bugs

There are no known outstanding bugs.

There was a bug in release 2.0 where length of strings containing names of dropped files was being set incorrectly. This was fixed inrelease 2.0.1.

In v3.0 and v3.1 the DropControl property did not always return the correct control. This was fixed in v3.2.

There was a small memory leak in all release 3 versions. This was fixed in release 4.0.

In release 4 there was a minor bug in the wildcard file filter where a change of wildcard was sometimes ignored. This was fixed in release 5.0.

» Contents

Change log

A complete change log is provided in a text file that is included in the download.

» Contents

License

This source code is subject to the Mozilla Public License Version 1.1 (the "License"); you may not use this program except in compliance with the License. You may obtain a copy of the License at http://www.mozilla.org/MPL/.

Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License.

The Original Code is Drop Files Components.

The Initial Developer of the Original Code is Peter Johnson (http://www.delphidabbler.com/).

Portions created by the Initial Developer are Copyright © 1998-2006 Peter Johnson. All Rights Reserved.

All relevant trademarks are acknowledged.

» Contents

About the author

I'm Peter Johnson – a hobbyist programmer living in Ceredigion in West Wales, UK, writing write mainly in Delphi. My programs are available for download from: http://www.delphidabbler.com/.

Please let me know if you have any comments about the components, if you have found a bug, or you want to suggest any updates.