dropfiles

删除文件组件

内容

• 描述
• 安装
• 演示程序
• 更新历史记录
• 许可证和免责声明
• 错误和功能请求
• 关于作者

描述

提供了三个组件，这些组件支持Windows Explorer的拖放以及可以过滤掉落文件的子公司组件。组件是：

• TPJDROPFILE-容器控件，将拖动的文件捕获到其客户端区域或儿童控件的客户端区域。
• tpformdropfiles-非视觉组件，该组件将拖动的文件从资源管理器拖动到包含组件的表单上。
• tpjctrldropfiles-非视觉组件，将拖动的文件从资源管理器拖动到关联的控件上。
• tpjextfilefilter-文件过滤器组件，该组件根据其扩展程序过滤文件。
• tpjWildCardFileFilter-文件过滤器组件，该文件根据DOS风格的通配符过滤文件。
• tpjfilefilter-文件过滤器组件的抽象基类。

一些设计时间帮助由组件和物业编辑提供。

Drop Files组件的关键功能是：

• 删除文件时会触发ondropfiles事件。
• 删除文件的名称可通过文件数组属性提供。为方便起见，第一个文件的名称也存储在文件名属性中。
• 可以将删除文件的列表配置为仅包括文件，仅文件夹或所有文件和文件夹。
• 可以删除掉落的文件夹，以便列出每个删除文件夹中的所有文件和子文件夹。
• 过滤器可以应用于删除的文件和文件夹。这是通过两种方式之一完成的：
  • 通过处理onFileFilter事件并确定要通过过滤器的文件和文件夹。
  • 通过将Drop File Component链接到特殊文件过滤器组件，该组件来自抽象的TPJFileFilter 。在这种情况下，删除的文件会由过滤器组件自动过滤。提供了两个过滤器组件：根据文件扩展名和TPJWildCardFileFilter过滤的TPJextFileFilter ，可使用DOS风格的野外卡过滤。开发人员可以通过从TPJFileFilter派生来创建进一步的过滤组件。
• 可以检索鼠标归档文件的鼠标协调，当时对鼠标光标下的任何控件的参考也可以检索。
• OnBeforedRop事件可用于在文件实际删除之前进行预处理。
• ISFOLDER数组属性告知文件属性中的等效项目是文件或文件夹。
• 删除文件时，可以将所有窗口放在前面。

兼容性

这些组件已在Delphi 7到XE4 Windows编译器（Delphi 2005除外）和Delphi XE2至XE4 64位编译器上进行了测试。这些组件被认为可以在编译器上编译回Delphi 3，但不能保证。

这些组件仅与VCL一起使用：它们与FireMonkey不兼容。

不支持.NET和非窗口平台。

安装

drop文件组件，其文档和演示程序在zip文件中提供。在安装之前，您需要从zip文件中提取所有文件，并保留目录结构。将提取以下文件：

• PJDropFiles.pas - 组件源代码。
• PJDropFiles.dcr - 组件调色板字形。
• PJDropFilesDsgn.pas - 属性编辑器和组件注册源代码。
• PJDropFilesDsgn.dfm - 属性编辑器表单。
• README.md - 此文件。
• CHANGELOG.md - 组件的更改日志。
• MPL-2.txt - Mozilla公共许可证v2.0。
• Documentation.URL - 组件在线文档的捷径。

除上述文件外，您还将找到两个演示项目的源代码， Demo1和Demo2子目录。

现在，您可以将组件安装到Delphi IDE中。 PJDropFiles.dcr PJDropFilesDsgn.dfm PJDropFiles.pas文件添加到设计时代包PJDropFilesDsgn.pas 。如果您需要帮助，请参见此处。

演示程序

下载中包括两个演示程序的源代码：

1. 主要演示程序练习所有三个下降文件组件和过滤器组件。
2. 一个程序，演示了如何使用框架的tpjctrldropfiles 。

这两个演示程序都要求Delphi 7最少。它们都与Delphi 32位和64位Windows编译器兼容。

有关演示的更多信息，请参见Demos目录中的文件README.md 。

更新历史记录

下载中包含的CHANGELOG.md中提供了完整的更改日志。

许可证和免责声明

这些组件按照Mozilla公共许可证v2.0的条款发布。

所有相关商标都得到了认可。

错误和功能请求

可以报告错误或通过项目的问题跟踪器要求的新功能。需要一个github帐户。

请检查是否已经为类似的报告或请求创建了问题。如果是这样，请在现有问题上添加包含尽可能多信息的评论，或者如果您无需添加，请添加一个？ （ :+1:注释。如果没有合适的现有问题，请添加新问题并提供尽可能多的信息。

关于作者

我是彼得·约翰逊（Peter Johnson） - 一位居住在英国西威尔士（Ceredigion）的业余爱好者程序员，主要在德尔菲（Delphi）写作。我的程序和其他库代码可从以下网站获得：https：//delphidabbler.com/。

该文档是版权所有©2005-2022，PD Johnson。