Welcome to the new DelphiDabbler Code Library Documentation.

This is a new site that's currently running on alpha code. There are going to be bugs. If you discover any, please report them on the site's issues page (GitHub account required). Thanks.

Warning: Many URLs are going to change. Refer to the README file to discover which library project's documentation has been completed.

PassThrough property

Project: Drop Files Components.

Unit: PJDropFiles.

Class: TPJCtrlDropFiles

Applies to: ~>5.0

property PassThrough: Boolean;

Description

PassThrough causes drop files messages to be optionally passed through to the owning form.

When the property is false (default), and the control is enabled, any drop files messages intercepted by this control on behalf of the managed control are not forwarded to the form.

When PassThrough is true, and the control is enabled, then normal processing occurs when files are dropped. WM_DROPFILES messages are converted to custom PJ_DROPFILES message and forwarded to the form. Any TPJFormDropFiles component on the form can intercept PJ_DROPFILES messages and handle them like a standard WM_DROPFILES message.

When the drop files message is passed through, the drop point is converted into form coordinates and sent to the form as part of the PJ_DROPFILES message. In this way a TPJFormDropFiles component has its DropPoint property set to the correct value in terms of the form.