dropfiles

Déposez les composants des fichiers

Contenu

• Description
• Installation
• Programmes de démonstration
• Mettre à jour l'historique
• Licence et avertissement
• Bogues et demandes de fonctionnalités
• À propos de l'auteur

Description

Trois composants sont fournis qui prennent en charge le glisser-déposer de Windows Explorer ainsi que les composants subsidiaires qui peuvent filtrer les fichiers supprimés. Les composants sont:

• TPJDROPFILES - Contrôle des conteneurs qui attrape des fichiers glisser et déposé sur sa zone client ou la zone client des contrôles des enfants.
• TPFormdropFiles - Composant non visuel qui attrape des fichiers glisser et déposé de l'explorateur sur le formulaire qui contient le composant.
• TPJCTRLDROPFILES - Composant non visuel qui attrape des fichiers glisses et déposés de l'Explorer sur un contrôle associé.
• TPJextFileFilter - Composant de filtre de fichier qui filtre les fichiers en fonction de leur extension.
• TPJWILDCARDFILEFILTER - Composant de filtre de fichiers qui filtre les fichiers en fonction d'un joker de style DOS.
• TPJFileFilter - Une classe de base abstraite pour les composants de filtre de fichiers.

Une certaine aide à la conception est fournie par les éditeurs de composants et de propriétés.

Les fonctionnalités clés des composants de fichiers Drop sont:

• Un événement OndropFiles est déclenché lorsque les fichiers sont supprimés.
• Les noms des fichiers supprimés sont mis à disposition via la propriété Array des fichiers . Pour plus de commodité, le nom du premier fichier est également stocké dans la propriété du nom de fichier .
• La liste des fichiers supprimés peut être configurée pour inclure uniquement les fichiers, uniquement des dossiers ou tous les fichiers et dossiers.
• Les dossiers abandonnés peuvent être récursvés afin que tous les fichiers et sous-reprendurs de chacun des dossiers supprimés soient répertoriés.
• Les filtres peuvent être appliqués aux fichiers et dossiers supprimés. Cela se fait de deux manières:
  • En gérant l'événement OnFileFilter et en décidant quels fichiers et dossiers traversent le filtre.
  • En liant le composant de fichier DROP à un composant de filtre de fichier spécial, dérivé du résumé tpjfileFilter . Dans ce cas, les fichiers supprimés sont automatiquement filtrés par le composant filtrant. Deux composants de filtre sont fournis: TPJexxtFileFilter qui filtre en fonction des extensions de fichiers et tpjwildcardFilter qui filtre à l'aide de joker de style dos. Les développeurs peuvent créer d'autres composants de filtre en dérivant de TPJFileFilter .
• La souris coordonne où les fichiers ont été supprimés peuvent être récupérés, tout comme une référence à n'importe quel contrôle sous le curseur de la souris à l'époque.
• L'événement OnBeforedRop peut être utilisé pour effectuer le prétraitement avant que les fichiers ne soient réellement supprimés.
• La propriété Isfolder Array Informe si un élément équivalent dans la propriété Fichiers est un fichier ou un dossier.
• La fenêtre de possession peut être amenée à l'avant lorsque les fichiers sont supprimés.

Compatibilité

Les composants ont été testés sur les compilateurs Windows Delphi 7 à Xe4 (sauf Delphi 2005) et les compilateurs Delphi XE2 vers XE4 64 bits. On pense que les composants se compilent sur les compilateurs à Delphi 3, mais cela n'est pas garanti.

Les composants sont utilisés avec le VCL uniquement: ils ne sont pas compatibles avec FiremonKey.

Les plates-formes .NET et non-Windows ne sont pas prises en charge.

Installation

Les composants de fichiers DROP , leur documentation et les programmes de démonstration sont fournis dans un fichier zip. Avant l'installation, vous devez extraire tous les fichiers du fichier zip, en préservant la structure du répertoire. Les fichiers suivants seront extraits:

• PJDropFiles.pas - code source de composant.
• PJDropFiles.dcr - Glyphes de palette de composants.
• PJDropFilesDsgn.pas - Éditeurs de propriétés et code source d'enregistrement des composants.
• PJDropFilesDsgn.dfm - Formulaire d'éditeur de propriétés.
• README.md - ce fichier.
• CHANGELOG.md - Journal de modification du composant.
• MPL-2.txt - La Licence publique Mozilla v2.0.
• Documentation.URL - Rétablissement de la documentation en ligne du composant.

En plus des fichiers ci-dessus, vous trouverez le code source de deux projets de démonstration des sous-répertoires Demo1 et Demo2 .

Vous pouvez désormais installer les composants dans le Delphi IDE. Pour ce faire, les fichiers PJDropFiles.pas , PJDropFiles.dcr , PJDropFilesDsgn.pas et PJDropFilesDsgn.dfm doivent être ajoutés à un package de temps de conception. Si vous avez besoin d'aide pour le faire, voyez ici.

Programmes de démonstration

Le code source de deux programmes de démonstration est inclus dans le téléchargement:

1. Le programme de démonstration principal exerce les trois composants de fichiers de dépôt et les composants du filtre.
2. Un programme qui montre comment utiliser TPJCTRLDROPFILES avec des trames.

Les deux programmes de démonstration nécessitent Delphi 7 au minimum. Ils sont tous deux compatibles avec les compilateurs Windows Delphi 32 bits et 64 bits.

Pour plus d'informations sur les démos, consultez le fichier README.md dans le répertoire Demos .

Mettre à jour l'historique

Un journal de changement complet est fourni dans CHANGELOG.md qui est inclus dans le téléchargement.

Licence et avertissement

Ces composants sont publiés en vertu des termes de la Licence publique de Mozilla v2.0.

Toutes les marques pertinentes sont reconnues.

Bogues et demandes de fonctionnalités

Des bogues peuvent être signalés ou de nouvelles fonctionnalités demandées via le tracker du numéro du projet. Un compte GitHub est requis.

Veuillez vérifier si un problème a déjà été créé pour un rapport ou une demande similaire. Si oui, veuillez ajouter un commentaire contenant autant d'informations que possible au problème existant, ou si vous n'avez rien à ajouter, ajoutez un? ( :+1: commentaire. S'il n'y a pas de problème existant approprié, veuillez ajouter un nouveau problème et donner autant d'informations que possible.

À propos de l'auteur

Je suis Peter Johnson - un programmeur d'amateur vivant à Ceredigion dans l'ouest du Pays de Galles, au Royaume-Uni, écrivant principalement à Delphi. Mes programmes et autres code de bibliothèque sont disponibles sur: https://delphidabbler.com/.

Ce document est Copyright © 2005-2022, PD Johnson.