Adobe 65011817 Extended User Guide - Page 151

Last updated 12/8/2009 EXTENDING FIREWORKS 147 The Document object Usage dom.setElementLocked(frameNum, layerNum, objectIndex, bLock, bAllLayers, bLockLayers) Arguments frameNum A zero-based integer that specifies the frame that contains the element or elements to be locked. To specify the current frame, pass -1. layerNum A zero-based integer that specifies the layer that contains the element or elements to be locked. To specify the current layer, pass -1. objectIndex A zero-based integer that specifies the element or elements to lock or unlock. 0 represents the topmost element in the specified layer. To lock or unlock all the elements in the specified layer, pass -1. bLock A Boolean value. If true, the element or elements are to be locked; if false, the elements are unlocked. bAllLayers A Boolean value. If true, all layers are specified; false otherwise. bLockLayers A Boolean value. If true, locks all layers; false otherwise. Returns Nothing. Description Sets the name of the selected element or elements. dom.setElementLockedByName() Availability Fireworks 8. Usage dom.setElementLockedByName(name, bLock) Arguments name A string that specifies the name of the element or elements to be locked or unlocked. If more than one element has the same name, the function locks or unlocks all of them. bLock A Boolean value. If true, the element or elements are locked; if false, they are unlocked. Returns An array of the elements for which the lock status is set. Description Locks or unlocks all the elements with the specified name. If no element has the specified name an exception is thrown. If elements are hidden (for example, if they are on a hidden layer or frame), the function will not lock them. dom.setElementMaskMode() Availability Fireworks 4.