setpropertyvalue (AutoLISP)

Sets the property value for an entity

Supported Platforms: Windows and Mac OS

Signature

(setpropertyvalue ename propertyname value [or collectionName index name val])

ename

Type: ads_name

Name of the entity being modified. The ename can refer to either a graphical or a non-graphical entity.

propertyname

Type: String

Name of the property to be modified. For a list of all the valid property names of a given object, use dumpallproperties.

value

Type: Integer, Real, String, List, T, or nil

Value to set the property to when the object is not a collection.

collectionName

Type: String

If the object is a collection object, the Collection name is passed here.

index

Type: Integer

The collection index to be modified.

name

Type: String

Name of the property in the collection to be modified.

val

Type: Integer, Real, String, List, T, or nil

Value to set the property to.

Return Values

Type: nil

nil is returned unless an error occurs when the property value is being updated.

Examples

The following example demonstrates how to change the radius of a circle.

(command "_circle" "2,2" 2)
nil

(setpropertyvalue (entlast) "radius" 3)
nil

The following example demonstrates how to apply overrides to a linear dimension.

(command "_dimlinear" "2,2" "5,4" "3,3")
nil

(setq e2 (entlast))
<Entity name: 10e2e4bd0>

(setpropertyvalue e2 "Dimtfill" 2)
nil

(setpropertyvalue e2 "Dimtfillclr" "2")
nil

(setpropertyvalue e2 "Dimclrt" "255,0,0")
nil

The following example demonstrates how to change the first vertex of the Vertices collection.

(command "_pline" "0,0" "3,3" "5,2" "")
nil

(setq e3 (entlast))
<Entity name: 10e2e4da0>

(setpropertyvalue e3 "Vertices" 0 "EndWidth" 1.0)
nil