Finder.move
| Syntax |
Finder.move (path, moveTo, replacing)
|
| Params |
path (original Finder) is the path to the file or folder you wish to relocate. moveTo (original Finder) is the path to the folder where the contents of sourcePath are to be moved. path (Scriptable Finder) the path or other specification of the item to move, or a list of one or more items to move moveTo (Scriptable Finder) a specification of the container to which to move the items replacing (Scriptable Finder ONLY, optional) if false or absent do not replace existing items, if true, conflicts, or existingItems replace any existing items
|
| Action |
Moves the contents of path to the container at moveTo.
|
| Returns |
True (original Finder) (Scriptable Finder) A Finder specifier or list of specifers for the moved items in their new location
|
| Examples |
Finder.move ("System:System Folder:Passwords", "System:A Safe Place:") » true The file called "Passwords" in your System Folder is moved to a safe place, where all good passwords should be!
|
| Platform Notes |
This verb is only implemented in the Mac OS version of Frontier.
|
| Errors |
With Scriptable Finder, it is an error if the replacing parameter is absent or false and duplicate items already exist in the moveTo container.
|
| Notes |
With the original Finder, Finder.move () cannot be used to move files between volumes. Use Finder.drag for this purpose but remember that dragging leaves the original file in place. With the Scriptable FInder, Finder.move () will copy the items to the desired container, but not remove them from their orignal container. It is possible but not generally useful to specify a list of containers in the moveTo parameter. If you do, the items are moved multiple times, ending in the last container in the list.
|
| See Also |
file.copy
|
