copyResource

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
copyResource(<file>, <destinationFile>, <resType>,{<resID> | <resName>}[, <newID>])
Summary

Copies a resource from one Mac OS file to another.

Introduced1.0
Changes

The copyResource function was deprecated in LiveCode 8.1, since the versions of MacOS supported by LiveCode no longer support resource forks. It should not be used in any new code.

Deprecated8.1
OSmac
Platformsdesktop
Parameters
NameTypeDescription
file

The name and location of the file containing the resource. If you specify a name but not a location, LiveCode assumes the file is in the defaultFolder.

destinationFile

The name and location of the file you want to copy the resource to.

resType

The 4-character type of the resource you want to move.

resID

An integer that specifies the resource ID of the resource you want to copy.

resName

The name of the resource you want to copy.

newID

An integer that specifies the resource ID for the newly-copied resource.

Example
get copyResource("Template","New Build","vers",1,1)
put copyResource(theFile,anotherFile,"XCMD","SetPort") into trashVar
get copyResource(field "Source",currentFile,nextResource,200)
Values
NameTypeDescription
return

The copyResource function always returns empty.

The result

If the file does not exist, the result is set to "can't find file". If the destinationFile does not exist, the copyResource function creates the file, but the result is set to "can't create resource fork for destination file". If the destinationFile exists but has no resource fork. the copyResource function creates the resource fork and copies the resource to it. If the destinationFile is open, the result is set to "Can't open resource fork".

RelatedKeyword: file
Command: copy
Function: result, setResource
Control Structure: function
Glossary: resource fork, resource, Mac OS, return
Securitydisk
Description

Use the copyResource function to copy resources (such as icons, externals, and version resources) from one file to another.

If you don't specify a newID, the new resource has the same ID as the original resource. Specifying a newID does not change the resource ID of the original resource in the file; it only affects the copy in the destinationFile.

Tagsfile system