Replaces the selected set of point features of the specified feature layer with the provided block insert entity. This function provides programmatic control of the apply symbol context menu options of feature layers.
Note:
This function honors the currently selected features of the specified feature layer. If no features are selected the function applies to all features of the specified feature layer.
Syntax
(esri_featurelayer_applysymbol flname subtype blkname)
Arguments
- flname [String] (required)—An existing document feature layer name or web feature layer name in the drawing.
- subtype [String] (required)— Subtype of the feature layer name, or empty string for all ("") subtypes.
- blkname [String] (required)— The name of the block defined in the drawing used to replace the entities of the selected features of the specified feature layer.
Example usage
Attempt to replace the entities of the selected features of the Manholes feature layer with WTR_MANHOLE block insert entities. (esri_featurelayer_applysymbol "Manholes" "" "WTR_MANHOLE")
Result example usage
Replaces the entities of the selected features of the Manholes feature layer with WTR_MANHOLE block insert entities, and returns a list of true:
(T)Return values
- If successful, returns a list of true: (T)
- If failed: An AutoCAD list expression is returned with nil as the first argument and then an association list where an "Error" string is associated with a message.
- (nil ("Error" . "Feature layer not found"))
The specified feature layer is not found in the drawing.
- (nil ("Error" . "Missing required
argument."))
Refer to LISP routine's syntax for usage.
- (nil ("Error" . "Feature layer not found"))