FsiMonitorAdd

obj -> FsiMonitorAdd(alpha1[, int2[, alpha3[, alpha4]]])

Verzeichnis überwachen

Details

• obj: Deskriptor der Verzeichnisüberwachung
• alpha1: Name des zu überwachenden Verzeichnisses
• int2:
  • Option (optional):
  • _FsiMonFlagsSubDirs
  • _FsiMonFlagsNoDirChanges
• alpha3: nicht zu überwachende Dateien (optional)
• alpha4: zu überwachende Dateien (optional)
• Siehe: Verwandte Befehle , EvtFsiMonitor

Mit diesem Befehl wird das Verzeichnis bestimmt, das überwacht werden soll. Die Anweisung kann mehrmals aufgerufen werden, um verschiedene Verzeichnisse zu überwachen.

Als (obj) wird der Deskriptor verwendet, der von dem Befehl FsiMonitorOpen () zurückgegeben wurde.

Das zu überwachende Verzeichnis wird als (alpha1) übergeben. Das _Sys-Objekt stellt über seine Path-Eigenschaften einige Systempfade zur Verfügung.

Die Angabe der weiteren Parameter ist optional. Werden keine weiteren Parameter angegeben, wird bei jeder Änderung in dem angegebenen Verzeichnis das Ereignis EvtFsiMonitor aufgerufen.

Mit der Option _FsiMonFlagsSubDirs können auch die untergeordnete Verzeichnisse mit überwacht werden.

Mit den Parametern (alpha3) und (alpha4) können bestimmte Dateien aus der Überwachung aus- bzw. eingeschlossen werden. Dabei können auch mehrere Dateimasken durch ein Semikolon getrennt angegegben werden. Die Überwachung wird mit der Anweisung FsiMonitorControl () gestartet bzw. angehalten.

Beispiele:

// Alle Änderungen in den "Eigenen Dateien" überwachen
tFsiMonitor->FsiMonitorAdd(_Sys->spPathMyDocuments);

// Alle Änderungen in den "Eigenen Dateien" außer temporäre Dateien überwachen
tFsiMonitor->FsiMonitorAdd(_Sys->spPathMyDocuments, 0, '~*.*;*.tmp');

// Die Überwachung auch auf die untergeordneten Verzeichnisse ausdehnen
tFsiMonitor->FsiMonitorAdd(_Sys->spPathMyDocuments, _FsiMonFlagsSubDirs, '~*.*;*.tmp');

// "Eigene Bilder", "Eigene Filme" und "Temp" (mit Unterverzeichnissen) überwachen
tFsiMonitor->FsiMonitorAdd(_Sys->spPathMyPictures);
tFsiMonitor->FsiMonitorAdd(_Sys->spPathMyVideo);
tFsiMonitor->FsiMonitorAdd(_Sys->spPathTemp, _FsiMonFlagsSubDirs);

// Im Temp-Verzeichnis nur die Bildformate überwachen
tFsiMonitor->FsiMonitorAdd(_Sys->spPathTemp, 0, '', '*.bmp;*.jpg;*.tif;*.gif');

// Überwachung aktivieren
tFsiMonitor->FsiMonitorControl(_FsiMonitorStart);

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der angegebene Deskriptor ist kein Deskriptor einer Überwachung oder ist ungültig.