Form object
Moves all appendices belonging to the current form to a new folder and renames them at the same time. The files are renamed according to FORMS standard, based on the format MDHmmnnn.xxx., where:
M = month (1– 9, then A, B, C)
D = day (1– 9, then A– V)
H = hour (1– 9, then A– N where, for example, F stands for 15:00 or 3 PM)
mm = minute and nnn is a sequential number during any minute. An even sequence number indicates the front page of a form; an odd one indicates the back of a form.
xxx = file extension, for example tif indicates TIFF format.
Note that in FORMS all appendices belong to a single form definition must be in one folder, not divided up among different folders.
NewDir is a string containing the new folder name, including its full path. For example, c:\images\div is correct but div is not. The folder must already exist when the method is called.
The method returns 0 if the operation was successful and 1 if it was not.
FormScanEnd would be an appropriate event from which to call this method.
This method cannot be used in FORMS Interpret if you are importing image files, because in that case you do not have access to appendices. The method works in Interpret only if you are interpreting forms from the database (forms that have been scanned using FORMS Scan).