|
|
|
|
- Special cases
- WLanguage procedure
fWatchDirectory (Function) In french: fSurveilleRepertoire
Warning
From version 2024, fTrackDirectory is kept for backward compatibility. This function has been replaced with fWatchDirectory.
Detects changes made to the contents of a directory. Only changes made to the files in the directory are detected. If a change is made, a specific procedure is executed in a thread.
sDirectoryName is string = "C:\Temp\MyDir"
IF fWatchDirectory(sDirectoryName, fWatchDirectory_Callback, fwCreateFile + ...
fwModifyFile + fwDeleteFile + fwRename) THEN
Info("The " + sDirectoryName + " directory will be watched.")
ELSE
Info("The " + sDirectoryName + " directory will not be watched.")
END
PROCEDURE fWatchDirectory_Callback(sDirectoryName, sFileName, nAction, sOldFileName)
ExecuteMainThread(AddTable,sDirectoryName, sFileName, nAction, sOldFileName)
PROCEDURE AddTable(sDirectoryName, sFileName, nAction, sOldFileName)
sActionDesignation is string
SWITCH nAction
CASE fwCreateFile: sActionDesignation = "Creating files"
CASE fwDeleteFile: sActionDesignation = "Deleting files"
CASE fwModifyFile: sActionDesignation = "Modifying files"
CASE fwRename: sActionDesignation = "Renaming files"
END
TableAddLine(TABLE_MODIFICATIONS, sDirectoryName, sFileName, , ...
sActionDesignation, sOldFileName)
Syntax
<Result> = fWatchDirectory(<Directory to watch> , <WLanguage procedure> [, <Changes to notify> [, <Subdirectory>]])
<Result>: Boolean - True if directory watch is enabled,
- False otherwise. To get more details on the error, use ErrorInfo.
<Directory to watch>: Character string Full name of the directory to be watched. <WLanguage procedure>: Procedure name Name of the WLanguage procedure ("callback") called when a change is made in the specified directory. <Changes to notify>: Optional Integer constant (or combination of constants) Changes made to the contents of the directory to be watched and for which the procedure is to be executed: | | fwAll | All actions are watched. Corresponds to fwCreateFile + fwModifyFile + fwRename + fwDeleteFile.New in version 2024Before version 29 Update 2, this constant was named ftAll. | fwCreateFile | Creation of a file or directory.New in version 2024Before version 29 Update 2, this constant was named ftCreateFile. | fwDeleteFile | Deletion of a file or directory.New in version 2024Before version 29 Update 2, this constant was named ftDeleteFile. | fwModifyFile | Changes to a file or directory.New in version 2024Before version 29 Update 2, this constant was named ftModifyFile. | fwRename | Renaming of a file or directory.New in version 2024Before version 29 Update 2, this constant was named ftRename. |
<Subdirectory>: Boolean - True (default) to process the sub-directories.
- False otherwise.
Remarks Special cases - fWatchDirectory only watches the contents of the directory. The changes of directory name or location are ignored.
- To stop watching the directory, use fWatchStop and fWatchStopAll.
- To watch the changes made to a file, use fWatchFile.
- Limitation: Only 5 directories can be watched at the same time.
WLanguage procedure The WLanguage procedure is run in a WLanguage thread. Caution: The following processes cannot be run in threads: - opening windows with WLanguage functions such as Open, Use, Close, ... A specific management mode must be implemented if some windows must be handled in threads (rare case). For more details, see Opening a window in a secondary thread.
- managing events.
- managing timers.
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|