Filer.dll

Artikel
04/01/2008

Filer.dll ist eine Komponentenversion des in früheren Versionen von Microsoft Visual FoxPro (Version 3.0b und früher) verfügbaren Dienstprogramms Filer. Filer.dll unterstützt die bekanntesten Eigenschaften von Filer wie die Suche nach Textzeichenfolgen in Dateien oder das Öffnen mehrerer Dateien zur Bearbeitung.

Filer.dll ist ein COM-Objekt und unterstützt als solches Automatisierung. Aus diesem Grund können Sie in Visual FoxPro oder anderen Automatisierungsservern, z. B. Microsoft Visual Basic und Microsoft Excel, Instanzen von Filer.dll erzeugen.

Filer.dll ist eine Basiskomponente, die das Suchmodul für die Suche nach Dateien und Texten bereitstellt, jedoch über keine Benutzeroberfläche verfügt. Somit können Sie beispielsweise programmgesteuert eine Instanz von Filer erzeugen und ohne jegliche Eingabe des Benutzers nach Dateien suchen und diese verändern. Es wird jedoch das Visual FoxPro-Formular Filer.scx (und Filer.sct) bereitgestellt, um die Erstellung einer Benutzeroberfläche für Filer.dll zu demonstrieren.

Der folgende Befehl erzeugt in Visual FoxPro eine Instanz des nichtvisuellen Filer-Suchmoduls. Die Syntax für andere Automatisierungsserver ist ähnlich.

oMyFiler = CREATEOBJECT('Filer.FileUtil')

Nach der Instanziierung des Filer-Objekts können Sie mit Hilfe der Filer-Eigenschaften Suchbedingungen angeben und unter Verwendung der Find()-Methode die Dateisuche durchführen. Durch die Find-Methode wird ein Objekt der Files-Auflistung mit eigenen Eigenschaften erstellt, die es Ihnen ermöglichen, Informationen über die Dateien zu erhalten, die den Suchbedingungen entsprechen. Darüber hinaus stehen für das Objekt der Files-Auflistung Methoden bereit, die es Ihnen ermöglichen, die übereinstimmenden Dateien zu öffnen oder zu löschen.

Das folgende einfache Visual FoxPro-Beispiel zeigt, wie Sie in Visual FoxPro nach Textdateien suchen und diese öffnen können.

*** Instantiate the Filer object
oMyFiler = CREATEOBJECT('Filer.FileUtil')

oMyFiler.SearchPath = C:\Program Files\Microsoft Visual FoxPro 7.0' && Default directory
oMyFiler.FileExpression = '*.TXT' && Text file search

oMyFiler.Find(0) && Search, discard last collection

FOR nFileCount = 1 TO oMyFiler.Files.Count
   oMyFiler.Files.Item(nFileCount).Edit && Open files
ENDFOR

Vertrieb

Sie können Filer.dll und die Begleitdateien filer.ico, filer.scx und filer.sct mit den für den Vertrieb vorgesehenen Visual FoxPro-Laufzeitanwendungen vertreiben.

Anmerkung Für diese Dateien wird kein Support bereitgestellt, d. h., Sie erhalten keinen technischen Support, falls bei der Verwendung dieser Dateien Probleme auftreten sollten.

Eigenschaften des "Filer"-Objekts

In der folgenden Tabelle werden die mit dem Filer-Objekt assoziierten Eigenschaften beschrieben.

Eigenschaft	Datentyp	Beschreibung
SearchPath	C	Der Ordner, in dem die Suche beginnt. Die UNC-Benennungskonventionen werden unterstützt. Der Standardordner ist C:\Programme\Microsoft Visual FoxPro 7.0. Lesen/Schreiben.
FileExpression	C	Die Dateisuchmaske; diese kann aus mehreren durch Semikola (;) getrennten Suchmasken bestehen. So gibt beispielsweise die Dateisuchmaske .scx; .sct eine Suche nach allen Dateien mit den Erweiterungen SCX und SCT an. Die Standard-Dateisuchmaske lautet .. Lesen/Schreiben.
SubFolder	N	Ein numerischer Wert, der angibt, ob beginnend bei dem durch die SearchPath-Eigenschaft angegebenen Ordner eine rekursive Suche durchgeführt wird. Hat SubFolder den Wert 0, findet die Dateisuche nur in dem durch die SearchPath-Eigenschaft angegebenen Ordner statt. Hat SubFolder den Wert 1, findet die Dateisuche in dem durch die SearchPath-Eigenschaft angegebenen Ordner und all seinen Unterordnern statt. Beachten Sie, dass Filer Systemordner ignoriert. Der Standardwert ist 0. Lesen/Schreiben.
SearchText1	C	Eine Textzeichenfolge, nach der in den Dateien gesucht wird, die der in der FileExpression-Eigenschaft angegebenen Dateisuchmaske entsprechen. Der Standardwert ist die leere Zeichenfolge. Lesen/Schreiben.
SearchText2	C	Eine zusätzliche Textzeichenfolge, nach der in den Dateien gesucht wird, die der in der FileExpression-Eigenschaft angegebenen Dateisuchmaske entsprechen. Diese Eigenschaft wird ignoriert, wenn SearchText1 die leere Zeichenfolge enthält. Der Standardwert ist die leere Zeichenfolge. Lesen/Schreiben.
SearchText3	C	Eine zusätzliche Textzeichenfolge, nach der in den Dateien gesucht wird, die der in der FileExpression-Eigenschaft angegebenen Dateisuchmaske entsprechen. Diese Eigenschaft wird ignoriert, wenn SearchText1 und SearchText2 die leere Zeichenfolge enthalten. Der Standardwert ist die leere Zeichenfolge. Lesen/Schreiben.
IgnoreCase	N	Ein numerischer Wert, der angibt, ob die Groß-/Kleinschreibung bei den Texten in den durch SearchText1, SearchText2 und SearchText3 angegebenen Textzeichenfolgen berücksichtigt wird oder nicht. Hat IgnoreCase den Wert 0, wird die Groß-/Kleinschreibung berücksichtigt. Hat IgnoreCase den Wert 1, wird die Groß-/Kleinschreibung nicht berücksichtigt. Der Standardwert ist 1. Lesen/Schreiben.
WholeWords	N	Ein numerischer Wert, der angibt, ob die Texte in den durch SearchText1, SearchText2 und SearchText3 angegebenen Textzeichenfolgen mit ganzen Wörtern übereinstimmen müssen, damit die Suche erfolgreich ist. Hat WholeWords den Wert 0, müssen die Texte in den Textzeichenfolgen nicht mit ganzen Worten übereinstimmen, damit die Suche erfolgreich ist. Hat WholeWords den Wert 1, müssen die Texte in den Textzeichenfolgen mit ganzen Wörtern übereinstimmen, damit die Suche erfolgreich ist. Der Standardwert ist 0. Lesen/Schreiben.
SearchAnd	N	Ein numerischer Wert, der angibt, ob Übereinstimmungen mit allen Texten in den durch SearchText1, SearchText2 und SearchText3 angegebenen Textzeichenfolgen gefunden werden müssen, damit die Suche erfolgreich ist. Hat SearchAnd den Wert 0, ist die Suche erfolgreich, wenn eine Übereinstimmung mit einem der Texte in den Textzeichenfolgen gefunden wird. Hat SearchAnd den Wert 1, ist die Suche nur erfolgreich, falls eine Übereinstimmung mit dem gesamten Text in den Textzeichenfolgen gefunden wird. Der Standardwert ist 0. Lesen/Schreiben.
Editor	C	Der Editor, in dem Dateien durch die Open-Methode der Files-Auflistung geöffnet werden. Diese Eigenschaft wird ignoriert, wenn die IsHostedByFox-Eigenschaft den Wert 1 hat. Der Standard-Editor ist der Microsoft-Editor. Lesen/Schreiben.
IsHostedByFox	N	Ein numerischer Wert, der angibt, welcher Client Filer.dll instanziiert hat. Hat IsHostedByFox den Wert 1, ist Visual FoxPro der Client, und der Visual FoxPro-Editor wird zum Öffnen von Dateien verwendet. Hat IsHostedByFox den Wert 0, handelt es sich bei dem Client um eine andere Anwendung als Visual FoxPro. Zum Öffnen von Dateien wird in diesem Fall der durch die Editor-Eigenschaft angegebene Editor verwendet. Der Standardwert ist 1 in Visual FoxPro. Lesen/Schreiben.
SortBy	N	Ein numerischer Wert, der die Reihenfolge angibt, in der die Files-Auflistung sortiert wird. Die folgende Tabelle führt die möglichen Werte der SortBy-Eigenschaft und die zugehörige Sortierung auf. 0 Keine Sortierung 1 Pfad- und Dateiname 2 Dateiname 3 Dateierweiterung 4 Dateigröße 5 Datum der letzten Speicherung der Datei 6 Datum des letzten Zugriffs auf die Datei 7 Dateierstellungsdatum 8 Dateiattribute Der Standardwert ist 1. Lesen/Schreiben.
SortDirection	N	Ein numerischer Wert, der angibt, ob die Files-Auflistung in aufsteigender oder absteigender Reihenfolge sortiert wird. Hat SortDirection den Wert 0, wird die Files-Auflistung in aufsteigender Reihenfolge sortiert. Hat SortDirection den Wert 1, wird die Files-Auflistung in absteigender Reihenfolge sortiert. Der Standardwert ist 0. Lesen/Schreiben.

Methoden des "Filer"-Objekts

Die folgende Tabelle beschreibt die mit dem Filer-Objekt assoziierten Methoden.

Methode	Beschreibung
Find(nValue)	Eine Methode, die die Suche durchführt und eine Files-Auflistung erzeugt. Die Find-Methode enthält einen numerischen Wert, der die Anzahl der Dateien in der Files-Auflistung angibt. NValue ist ein numerischer Wert, der angibt, ob die Files-Auflistungen früherer Suchen verworfen werden. Hat nValue den Wert 0, werden die Files-Auflistungen früherer Suchen verworfen. Hat nValue den Wert 1, wird die durch die aktuelle Suche erzeugte Files-Auflistung an die Files-Auflistungen früherer Suchvorgänge angehängt. Beachten Sie, dass nValue nicht optional ist.

Find(nValue)

Eine Methode, die die Suche durchführt und eine Files-Auflistung erzeugt. Die Find-Methode enthält einen numerischen Wert, der die Anzahl der Dateien in der Files-Auflistung angibt.

NValue ist ein numerischer Wert, der angibt, ob die Files-Auflistungen früherer Suchen verworfen werden. Hat nValue den Wert 0, werden die Files-Auflistungen früherer Suchen verworfen. Hat nValue den Wert 1, wird die durch die aktuelle Suche erzeugte Files-Auflistung an die Files-Auflistungen früherer Suchvorgänge angehängt.

Beachten Sie, dass nValue nicht optional ist.

Objekte der "Files"-Auflistung

Die folgende Tabelle beschreibt die mit der Files-Auflistung assoziierten Objektverweise.

Objekt	Beschreibung
Item(nValue)	Ein Objektverweis auf eine Datei in der Files-Auflistung. nValue ist ein Index für eine Datei in der Files-Auflistung. nValue geht von 1 bis zur vollen Anzahl der Dateien in der Files-Auflistung. Zur Bestimmung der Anzahl der Dateien in der Files-Auflistung können Sie die weiter unten beschriebene Count-Eigenschaft verwenden.

Eigenschaften der "Files"-Auflistung

Die folgende Tabelle beschreibt die mit der Files-Auflistung assoziierten Eigenschaften.

Eigenschaft	Datentyp	Beschreibung
Count	N	Enthält die Anzahl der Dateien in der Files-Auflistung. Schreibgeschützt.
Name	C	Der Name der Datei einschließlich des Pfades. Schreibgeschützt.
Size	N	Die Größe der Datei in Byte. Schreibgeschützt.
SizeHigh	N	Die obersten vier Byte der Dateigröße, wenn diese vier Gigabyte übersteigt. Schreibgeschützt.
Attr	N	Die Windows-Dateiattribute der Datei. Im Folgenden finden Sie eine Liste der numerischen Werte typischer Dateiattribute. 0 Es wurden keine Attribute festgelegt 1 Schreibgeschützt 2 Versteckt 4 System 32 Archiv Der Wert von Attr kann sich aus mehreren Dateiattributen zusammensetzen. Hat Attr beispielsweise den Wert 7 (1+2+4), handelt es sich bei der Datei um eine verborgene, schreibgeschützte Systemdatei. Weitere Informationen über die anderen Dateiattribute, für die Attr einen Wert zurückgibt, finden Sie in der Beschreibung der GetFileAttributes-Funktion; Sie finden diese Beschreibung in der MSDN-Bibliothek (Microsoft Developer's Network Library). Lesen/Schreiben.
DateTime	N	Der Zeitstempel, der von Windows bei der Erzeugung einer Datei zugewiesen wird. Der ganzzahlige Anteil des Zeitstempels bezeichnet die Anzahl der Tage seit dem 30.12.1899, der Dezimalteil ist als Bruchteil eines Tages zu interpretieren und gibt die Uhrzeit der Erzeugung der Datei an. Das Filer-Formular Filer.scx enthält eine benutzerdefinierte Methode namens GetTime; diese demonstriert, wie Sie aus der DateTime-Eigenschaft Datum und Uhrzeit der Erstellung einer Datei ermitteln können. Schreibgeschützt.
LastAccessTime	N	Der Zeitstempel, der von Windows beim letzten Zugriff einer Datei zugewiesen wird. Schreibgeschützt.
LastWriteTime	N	Der Zeitstempel, der von Windows beim letzten Schreibzugriff einer Datei zugewiesen wird. Schreibgeschützt.
AlternateName	C	Der kurze Name der Datei, wenn die Länge des Dateinamens die der 8.3-Benennungskonvention von MS-DOS® überschreitet. Schreibgeschützt.
Path	C	Der vollständige Pfad der Datei. Schreibgeschützt.

Methoden der "Files"-Auflistung

Die folgende Tabelle beschreibt die mit der Files-Auflistung assoziierten Methoden.

Methode	Beschreibung
Edit	Öffnet die angegebene Datei zur Bearbeitung. Hat die IsHostedByFox-Eigenschaft den Wert 1 (Standardwert für Visual FoxPro), wird die Datei im Visual FoxPro-Editor geöffnet. Hat die IsHostedByFox-Eigenschaft den Wert 0, wird die Datei im durch die Editor-Eigenschaft angegebenen Editor (standardmäßig der Microsoft-Editor) geöffnet.
Delete	Löscht die angegebene Datei vom Datenträger. Die Datei wird nicht im Papierkorb gespeichert.

Ausführen von Filer.scx

Es wird ein Beispielformular Filer.scx mitgeliefert, das Ihnen zeigen soll, wie Sie in Visual FoxPro eine Benutzeroberfläche für Filer.dll erzeugen können. Um das Filer-Formular auszuführen, verwenden Sie wie im Folgenden angegeben den DO FORM-Befehl:

DO FORM (HOME(1) + 'Tools\Filer\Filer.scx')

Wenn Sie das Filer-Formular ausführen, wird zum Visual FoxPro-Menü Extras ein Filer-Element hinzugefügt, das während der aktuellen Visual FoxPro-Sitzung in diesem Menü erhalten bleibt. Um Filer erneut auszuführen, wählen Sie aus dem Menü Extras das Filer-Element.

Um den Code hinter der Schnittstelle zu untersuchen oder das Formular zu verändern, öffnen Sie das Formular mit dem folgenden Befehl:

MODIFY FORM (HOME(1) + 'Tools\Filer\Filer.scx')

Siehe auch

Fpole.dll | Laufzeitbibliothek VFP7R.DLL | Laufzeitbibliothek VFP7T.DLL | COMPOBJ( )-Funktion | DO FORM-Befehl

Freigeben über