Creating Custom Modification Scripts

Custom modification scripts can select multiple objects and modify their common properties and attributes in a single operation. Objects can be selected regardless of layer, layer scale, class, or current selection or visibility status. Several levels of selection criteria make it easy to target specific object sets for modification. No scripting knowledge is necessary.

To create a custom modification script:

1. Select Tools > Custom Modification.

The Custom Modification dialog box opens.

Click to show/hide the parameters.

Parameter	Description
Execute Immediately	Performs the specified selection operation immediately upon exiting the Custom Modification dialog box; the operation criteria is not saved for future use
Create VectorScript	Saves the criteria and command options as a VectorScript that can be reused
Create Python Script	Saves the criteria and command options as a Python script that can be reused
Selection Criteria	Determines the objects to select and modify based on the selected criteria
Including components of	Applies the selection to objects that are grouped and/or included in viewport annotations
Objects that meet the criteria	Displays the number of drawing objects that will be affected
More Choices/Fewer Choices	Specify additional criteria by clicking More Choices. To remove the most recently added level of criteria, click Fewer Choices.

2. Select the desired criteria options. The number of objects that meet the criteria displays.

When symbols are selected as the criteria and symbol folders are present in the file, click the button available near the symbol type to open the Select Symbol dialog box. Select the specific symbol, and then click OK to return to the Custom Modification dialog box.

3. Click OK.

If the Create Script option is chosen, when prompted, name the script containing the modification commands. The script then displays in a script palette, and can be double-clicked to perform the operation. See Creating and Editing Script Palettes and Scripts.

4. If the Execute Immediately option is chosen, the Properties dialog box opens.

The common properties of the selected objects are displayed and can be modified. Similar to a multiple selection, if the parameter settings for the objects are different, they display as a blank list or as a check box of indeterminate state. Parameter edits apply to all selected objects when in multiple edit mode.

 

5. To edit the object attributes, click Attributes.

The Attributes dialog box opens. Edit the available attributes of the selected objects, and click OK. See The Attributes Palette for more information.

6. Click OK to return to the drawing.

~~~~~~~~~~~~~~~~~~~~~~~~~

Using Scripts

Running Scripts

Was this page helpful?

vectorworks.net