dropfiles

Отбросить компоненты файлов

Содержимое

• Описание
• Установка
• Демо -программы
• Обновление истории
• Лицензия и отказ от ответственности
• Ошибки и запросы функций
• Об авторе

Описание

Поставляются три компонента, которые поддерживают перетаскивание от Windows Explorer, а также дочерние компоненты, которые могут фильтровать падение файлов. Компоненты:

• TPJdropfiles - Контейнер управление, которое запечатлевает файлы, перетаскиваемые и сбрасывается на область клиента или в область клиента управления дочерними элементами.
• TPFORMDROPFILES - НЕ визуальный компонент, который залатывает файлы, перетаскиваемые и отброшенные из Explorer на форму, содержащую компонент.
• TPJCTRLDROPFILES - НЕ визуальный компонент, который улавливает файлы, перетаскиваемые и выпадают из Explorer на соответствующий элемент управления.
• TPJEXTFILEFILTER - Компонент фильтра файла, который фильтрует файлы в соответствии с их расширением.
• TPJWILDCARDFILEFILTER - Компонент фильтра файла, который фильтрует файлы в соответствии с дикой картой в стиле DOS.
• TPJFileFilter - абстрактный базовый класс для компонентов файла.

Некоторая помощь времени дизайна предоставляется компонентами и редакторами недвижимости.

Ключевые функции компонентов Drop Files:

• Событие OndropFiles запускается при отброшении файлов.
• Имена отброшенных файлов предоставляются через свойство массива файлов . Для удобства имя первого файла также хранится в свойстве имени файла .
• Список отброшенных файлов можно настроить, чтобы включить только файлы, только папки или все файлы и папки.
• Отброшенные папки могут быть повторно перечислены так, чтобы все файлы и подразделы в каждой из папки были перечислены.
• Фильтры могут быть применены к отброшенным файлам и папкам. Это делается одним из двух способов:
  • Обрабатывая событие OnFileFilter и решив, какие файлы и папки пройти через фильтр.
  • Связывая компонент Drop -файла с специальным компонентом файла фильтра, полученным из абстрактного TPJFileFilter . В этом случае сброшенные файлы автоматически фильтруются компонентом фильтра. Представлены два компонента фильтра: tpjextfilefilter , который фильтровал в соответствии с расширениями файлов и tpjwildcardfilefilter , которые фильтровали с использованием диких карт в стиле DOS. Разработчики могут создавать дополнительные компоненты фильтра, вытекая из TPJFileFilter .
• Мышь координирует, где были отброшены файлы, могут быть извлечены, как и ссылка на любое управление под курсором мыши в то время.
• Событие OnbeForedrop можно использовать для выполнения предварительной обработки до того, как файлы фактически будут отброшены.
• Свойство массива IsFolder сообщает, является ли эквивалентным элементом в свойстве файлов файл или папка.
• Собственное окно может быть доведено на переднюю часть, когда файлы будут отброшены.

Совместимость

Компоненты были протестированы на компиляторах Delphi от 7 до XE4 (за исключением Delphi 2005) и Delphi XE2 до XE4 64 -битные компиляторы. Считается, что компоненты компилируются на компиляторах обратно в Delphi 3, но это не гарантировано.

Компоненты предназначены только для VCL: они не совместимы с FireMonkey.

Платформы .NET и Nonwindows не поддерживаются.

Установка

Компоненты Drop Files , их документация и демонстрационные программы поставляются в zip -файле. Перед установкой необходимо извлечь все файлы из zip -файла, сохраняя структуру каталога. Будут извлечены следующие файлы:

• PJDropFiles.pas - исходный код компонента.
• PJDropFiles.dcr - глиф палитры компонентов.
• PJDropFilesDsgn.pas - Редакция свойств и исходный код регистрации компонентов.
• PJDropFilesDsgn.dfm - Форма редактора свойств.
• README.md - этот файл.
• CHANGELOG.md - журнал изменений компонента.
• MPL-2.txt -Общественная лицензия Mozilla v2.0.
• Documentation.URL -кратковременный к онлайн-документации компонента.

В дополнение к приведенным выше файлам вы найдете исходный код двух демонстрационных проектов Demo1 и Demo2 Sub-Secorectories.

Теперь вы можете установить компоненты в Delphi IDE. Для этого файлы PJDropFiles.pas , PJDropFiles.dcr , PJDropFilesDsgn.pas и PJDropFilesDsgn.dfm должны быть добавлены в пакет времени дизайна. Если вам нужна помощь, посмотрите здесь.

Демо -программы

Исходный код для двух демонстрационных программ включен в загрузку:

1. Основная демонстрационная программа осуществляет все три компонента Drop Files и компоненты фильтра.
2. Программа, которая демонстрирует, как использовать tpjctrldropfiles с кадрами.

Обе демонстрационные программы требуют Delphi 7 как минимум. Они оба совместимы с 32 -битными компиляторами Delphi и 64 -битными компиляторами Windows.

Для получения дополнительной информации о демонстрациях см. Файл README.md в каталоге Demos .

Обновление истории

Полный журнал изменений предоставлен в CHANGELOG.md , который включен в загрузку.

Лицензия и отказ от ответственности

Эти компоненты выпускаются в соответствии с условиями общественной лицензии Mozilla V2.0.

Все соответствующие товарные знаки признаны.

Ошибки и запросы функций

Ошибки могут быть сообщены или новые функции, запрошенные с помощью трекера проекта. Требуется учетная запись GitHub.

Пожалуйста, проверьте, если проблема уже была создана для аналогичного отчета или запроса. Если да, то добавьте комментарий, содержащий как можно больше информации, к существующей проблеме, или если вам нечего добавить, просто добавьте? ( :+1: Комментарий. Если нет подходящей существующей проблемы, добавьте новую проблему и дайте как можно больше информации.

Об авторе

Я Питер Джонсон - хобби -программист, живущий в Ceredigion в Западном Уэльсе, Великобритания, пишу в основном в Delphi. Мои программы и другой библиотечный код доступны по адресу: https://delphidabbler.com/.

Этот документ Copyright © 2005-2022, PD Johnson.