VS:ImportResToCurFileN: Difference between revisions
mNo edit summary |
No edit summary |
||
| Line 51: | Line 51: | ||
</remark> | </remark> | ||
<remark>January 23, 2023 Pat Stanford | |||
Per forum discussion with Lada Arsenyuk of Vectorworks, we have determined that ImportRestoCurFileN does a comparison check of the resource you are attempting to import and the resources in the current file. If the resource you are trying to import is an exact duplicate of a resource in the current file, then the resource is not imported and the Callback function is not called. | |||
If you always want to see the conflict dialog box then use ImportResourceToCurrentFile instead. | |||
https://forum.vectorworks.net/index.php?/topic/104434-importrestocurfilen-and-callback-function/&do=findComment&comment=457282 | |||
</remark> | |||
----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ||
<sample> | <sample> | ||
Revision as of 19:30, 23 January 2023
.VectorScript|VectorScript ..VS:Function Reference|Function Reference ..VS:Function_Reference_Appendix|Appendix
Description
Imports the indicated resource from the specified list to the current file, if it is not already in the current file, and returns the handle to the resource. It will use a callback function to determine how to handle duplicate resource.
FUNCTION ImportResToCurFileN(
listID :LONGINT;
index :LONGINT;
callback :PROCEDURE) : HANDLE;
def vs.ImportResToCurFileN(listID, index, callback):
return HANDLE
Parameters
listID LONGINT index LONGINT callback PROCEDURE
Remarks
Return values from callback determine how any conflict is handled:
eImportResourceConflictResult_DoNotImport = 0
eImportResourceConflictResult_Replace = 1
eImportResourceConflictResult_Rename = 2
The callback will be executed only when there are conflicts, and the return value will define how the conflict should be resolved (much like the radio buttons in the dialog) If you want to rename, then change the var parameter with a new unique name, otherwise it will execute the callback again.
Example
PROCEDURE testResCountSymFolders;
VAR
resList : LONGINT;
numRes : INTEGER;
h : HANDLE;
FUNCTION ImportResCallback(VAR resourceName:DYNARRAY OF CHAR) : INTEGER;
BEGIN
AlrtDialog( resourceName );
resourceName := Concat( resourceName , '-1' );
ImportResCallback := 2;
END;
BEGIN
{ list symbol folders in curr doc }
resList := BuildResourceList(16, 23, '', numRes );
h := ImportResToCurFileN( resList , 1, ImportResCallback );
alrtDialog(concat('numRes=', numRes , ' h=', h));
END;
RUN(testResCountSymFolders);
Version
Availability: from Vectorworks 2014