Remove
The remove method is for removing (deleting) tagged artwork from the document.
If you don't need the artwork in the document and are exporting vector formats, it makes more sense to remove the artwork than to hide it.
If you want to hide the object, set its visible property to false in either the appearance or attributes methods.
In a hand-authored sheet, an explicit blank tagSearch property value can prevent the method from using a broader target inherited from the header. In the Tools editor, however, blank Artwork Tags is normalized to the target header *; use the three-state Skip checkbox when a captured Tools row should not run. You can also set the generic * property to false or the generic skip property to true in a hand-authored sheet.
See the Remove Tool for the visual editor.
Example Spreadsheet
| * | cat | ||
| remove | skip | comment | |
| tagSearch | * | * | |
| dog | All artwork tagged dog or cat will be removed | ||
| dog | false | Only the dog will be removed | |
| dog | true | Only the cat will be removed | |
| "" | Only the cat will be removed, this would work even if a default dog tag was provided in the header's tagSearch property cell |
Remove Properties
| Property | Description |
|---|---|
tagSearch | The tag search of artwork to remove. |
* | Set to false if you want the method to be skipped in a particular row. Valid Values: true or false |
skip | Set to true if you want the method to be skipped in a particular row. See * and Skip for details. Valid Values: true or false |