entupd

AutoCad AutoLISP Functions

 
entupd
 
 
 

Updates the screen image of an object (entity)

(entupd ename)

Arguments

ename

The name of the entity to be updated on the screen.

Return Values

The entity (ename) updated; otherwise nil, if nothing was updated.

Examples

Assuming that the first entity in the drawing is a 3D polyline with several vertices, the following code modifies and redisplays the polyline:

(setq e1 (entnext))       ; Sets e1 to the polyline's entity
name
(setq e2 (entnext e1))    ; Sets e2 to its first vertex
(setq ed (entget e2))     ; Sets ed to the vertex data
(setq ed 
  (subst '(10 1.0 2.0)
    (assoc 10 ed)         ; Changes the vertex's location in ed 
    ed                    ; to point (1,2)
  ) 
) 
(entmod ed)               ; Moves
the vertex in the drawing
(entupd e1)               ; Regenerates
the polyline entity e1

Updating Polylines and Blocks

When a 3D (or old-style) polyline vertex or block attribute is modified with entmod, the entire complex entity is not updated on the screen. The entupd function can be used to cause a modified polyline or block to be updated on the screen. This function can be called with the entity name of any part of the polyline or block; it need not be the head entity. While entupd is intended for polylines and blocks with attributes, it can be called for any entity. It always regenerates the entity on the screen, including all subentities.

NoteIf entupd is used on a nested entity (an entity within a block) or on a block that contains nested entities, some of the entities might not be regenerated. To ensure complete regeneration, you must invoke the REGEN command in the Command Reference.
See Also