Apple AppleScript Finder Guide User Manual download pdf (Page 112)

CHAPTER 3

Finder Commands

100 Using Command Deﬁnitions

For example, here’s the syntax statement for the Move command from page 124:

move referenceToObject to referenceToContainer ¬

[ replacing ( conflicts | existing items ) ]

To use the Move command, you must replace the placeholders referenceToObject

and referenceToContainer with a reference to the object you want to move and a

reference to the container to which you want to move it, respectively. The

optional parameter in brackets indicates that you want the moved object to

replace any object in referenceToContainer that has the same name.

Parameters 3

Parameters are values that are included with a command. The “Parameters”

section of a command deﬁnition lists that command’s parameters and the

information you need to use them correctly.

Many commands include a direct parameter that speciﬁes the object of the

action. The direct parameter immediately follows the command. In the Move

command syntax described in the previous section, the referenceToObject

parameter is the direct parameter.

If a command includes parameters other than the direct parameter, they

are identiﬁed by labels. Parameters that are identiﬁed by labels are called

labeled parameters. In the Move command syntax, the to referenceToContainer

parameter is a labeled parameter with the label to, and the replacing

(conflicts | existing items) parameter is a labeled parameter with

the label replacing.

Each parameter value you supply must belong to a particular class, which

is listed in its description in the command deﬁnition. For example, the

referenceToObject and referenceToContainer parameters for the Move command

must both be references.

Parameters can be required or optional. Required parameters must be included

with the command; optional parameters need not be. Optional parameters

are enclosed in brackets in syntax descriptions. For optional parameters, the

description in the “Parameters” section speciﬁes a default value that is used

if you don’t include the parameter.

1 ... 111 112 113 ... 168

No comments

Apple AppleScript Finder Guide User Manual Page 112