Adobe 65036570 Scripting Guide - Page 571

ADOBE DIRECTOR 11.0 534 Scripting Dictionary • For property lists, setaProp replaces a property in the list specified by list. When the property isn't already in the list, Lingo adds the new property and value. • For child objects, setaProp replaces a property of the child object. When the property isn't already in the object, Lingo adds the new property and value. • The setaProp command can also set ancestor properties. Parameters listProperty Required. A symbol (Lingo only) or a string that specifies the name of the property whose value is changing. newValue Required. The new value for the listProperty property. Example These statements create a property list and then adds the item #c:10 to the list: newList = [#a:1, #b:5] put newList -- [#a:1, #b:5] setaProp newList, #c, 10 put newList Using the dot operator, you can alter the property value of a property already in a list without using setaProp: newList = [#a:1, #b:5] put newList -- [#a:1, #b:5] newList.b = 99 put newList -- [#a:1, #b:99] Note: To use the dot operator to manipulate a property, the property must already exist in the list, child object, or behavior. See also ancestor, property, . (dot operator) setAt Usage setAt list, orderNumber, value list[orderNumber] = value Description Command; replaces the item specified by orderNumber with the value specified by value in the list specified by list. When orderNumber is greater than the number of items in a property list, the setAt command returns a script error. When orderNumber is greater than the number of items in a linear list, Director expands the list's blank entries to provide the number of places specified by orderNumber. Example This handler assigns a name to the list [12, 34, 6, 7, 45], replaces the fourth item in the list with the value 10, and then displays the result in the Message window: --Lingo