dropfiles

Dateienkomponenten fallen

Inhalt

• Beschreibung
• Installation
• Demo -Programme
• Aktualisieren Sie die Geschichte
• Lizenz und Haftungsausschluss
• Fehler und Feature -Anfragen
• Über den Autor

Beschreibung

Es werden drei Komponenten bereitgestellt, die Drag & Drop von Windows Explorer zusammen mit Nebenkomponenten unterstützen, die fallengelassene Dateien filtern können. Die Komponenten sind:

• TPJDROPFILES - Containersteuerung, die die Dateien auf den Kundenbereich oder den Kundenbereich von untergeordneten Steuerelementen fangen.
• TPFormDroppInes - Nicht -visuelle Komponente, die Dateien fangen, die von Explorer in das Formular geschleppt und fallen, das die Komponente enthält.
• Tpjctrldropfiles - Nicht -visuelle Komponente, die Dateien erwischt, die von Explorer auf eine zugehörige Steuerung geschleppt und fallen.
• TPJEXTFILEFILTER - Dateifilterkomponente, die Dateien gemäß ihrer Erweiterung filtert.
• TPJWILDCARDFILEFILTER - Dateifilterkomponente, die Dateien gemäß einer Wildkarte im DOS -Stil filtert.
• TPJFileFilter - Eine abstrakte Basisklasse für Dateifilterkomponenten.

Einige Entwurfszeitunterstützung werden von Komponenten- und Eigenschaftsredakteuren bereitgestellt.

Die wichtigsten Funktionen der DROP -Dateienkomponenten sind:

• Ein Ereignis von ONDROPFILES wird ausgelöst, wenn Dateien fallen gelassen werden.
• Die Namen der fallengelassenen Dateien werden über die Dateien -Array -Eigenschaft zur Verfügung gestellt. Der Name der ersten Datei wird auch in der Dateiname -Eigenschaft gespeichert.
• Die Liste der fallengelassenen Dateien kann so konfiguriert werden, dass nur Dateien, Ordner oder alle Dateien und Ordner enthalten sind.
• Fallengelassene Ordner können so wiedergegeben werden, dass alle Dateien und Unterordner in jedem der gelöschten Ordner aufgeführt sind.
• Filter können auf die fallengelassenen Dateien und Ordner angewendet werden. Dies geschieht auf zwei Arten:
  • Durch die Behandlung des Onfilefilter -Ereignisses und die Entscheidung, welche Dateien und Ordner den Filter durchlaufen sollen.
  • Durch Verknüpfen der Drop -Datei -Komponente mit einer speziellen Dateifilterkomponente, abgeleitet vom abstrakten TPJFileFilter . In diesem Fall werden die fallengelassenen Dateien automatisch von der Filterkomponente gefiltert. Es werden zwei Filterkomponenten bereitgestellt: TPJEXTFILEFILTER , der nach Dateierweiterungen und TPJWildCardFileFilter filtert, die mit Wildkarten im DOS-Stil filtert. Entwickler können weitere Filterkomponenten erstellen, indem sie von TPJFileFilter abgeleitet werden.
• Die Mauskoordinaten, bei denen die Dateien fallen gelassen wurden, können abgerufen werden, ebenso wie ein Hinweis auf jede Kontrolle unter dem Mauszeiger zu diesem Zeitpunkt.
• Mit dem Ereignis für das ONBeForedrop kann vor dem Verarbeitung vorverarbeitet werden, bevor die Dateien tatsächlich fallen gelassen werden.
• Die Eigenschaft IsFolder Array informiert, ob ein äquivalenter Element in der Dateien -Eigenschaft eine Datei oder ein Ordner ist.
• Das besitzende Fenster kann nach Abbruch der Dateien nach vorne gebracht werden.

Kompatibilität

Die Komponenten wurden auf Delphi 7 an XE4 -Windows -Compiler (außer Delphi 2005) und den Delphi XE2 bis XE4 64 -Bit -Compilern getestet. Es wird angenommen, dass die Komponenten an Compiler zurück zu Delphi 3 kompiliert werden, aber das ist nicht garantiert.

Die Komponenten sind nur mit der VCL verwendet: Sie sind nicht mit Fironemonkey kompatibel.

.NET- und Nicht-Windows-Plattformen werden nicht unterstützt.

Installation

Die Komponenten der Drop -Dateien , deren Dokumentation und Demo -Programme werden in einer ZIP -Datei bereitgestellt. Vor der Installation müssen Sie alle Dateien aus der ZIP -Datei extrahieren und die Verzeichnisstruktur erhalten. Die folgenden Dateien werden extrahiert:

• PJDropFiles.pas - Komponentenquellcode.
• PJDropFiles.dcr - Komponenten -Palettenglyphen.
• PJDropFilesDsgn.pas - Eigenschaftsredakteure und Komponentenregistrierungsquellencode.
• PJDropFilesDsgn.dfm - Eigenschaftseditorformular.
• README.md - diese Datei.
• CHANGELOG.md - Change -Protokoll der Komponente.
• MPL-2.txt -Die Mozilla Public Lizenz v2.0.
• Documentation.URL -Kurzzeit in die Online-Dokumentation der Komponente.

Zusätzlich zu den oben genannten Dateien finden Sie den Quellcode von zwei Demo-Projekten, die die Demo1 und Demo2 Unterabschreibungen haben.

Sie können nun die Komponenten in der Delphi -IDE einbauen. Zu diesem Zweck sollten die Dateien PJDropFiles.pas , PJDropFiles.dcr , PJDropFilesDsgn.pas und PJDropFilesDsgn.dfm zu einem Entwurfszeitpaket hinzugefügt werden. Wenn Sie Hilfe benötigen, siehe hier.

Demo -Programme

Der Quellcode für zwei Demo -Programme ist im Download enthalten:

1. Das Hauptdemo -Programm übt alle drei DROP -Dateienkomponenten und die Filterkomponenten aus.
2. Ein Programm, das demonstriert, wie TPJCtrldropfiles mit Frames verwendet werden.

Beide Demo -Programme erfordern mindestens Delphi 7. Sie sind beide mit den Delphi 32 -Bit- und 64 -Bit -Windows -Compilern kompatibel.

Weitere Informationen zu den Demos finden Sie in der Datei README.md im Demos -Verzeichnis.

Aktualisieren Sie die Geschichte

Ein vollständiges Änderungsprotokoll finden Sie in CHANGELOG.md , das im Download enthalten ist.

Lizenz und Haftungsausschluss

Diese Komponenten werden unter den Bestimmungen der Mozilla Public Lizenz v2.0 veröffentlicht.

Alle relevanten Marken werden anerkannt.

Fehler und Feature -Anfragen

Fehler können gemeldet oder neue Funktionen über den Ausgaber -Tracker des Projekts angefordert werden. Ein GitHub -Konto ist erforderlich.

Bitte überprüfen Sie, ob bereits ein Problem für einen ähnlichen Bericht oder eine ähnliche Anfrage erstellt wurde. Wenn ja, fügen Sie bitte einen Kommentar hinzu, der so viele Informationen wie möglich zu dem vorhandenen Problem enthält, oder wenn Sie nichts hinzufügen, fügen Sie einfach eine hinzu? ( :+1: Kommentar. Wenn es kein geeignetes Problem gibt, fügen Sie bitte ein neues Problem hinzu und geben Sie so viele Informationen wie möglich an.

Über den Autor

Ich bin Peter Johnson - ein hobbyistischer Programmierer, der in Ceredigion in West Wales, Großbritannien, hauptsächlich in Delphi lebt. Meine Programme und andere Bibliothekscode finden Sie unter: https://delphidabbler.com/.

Dieses Dokument ist das Copyright © 2005-2022, PD Johnson.