acdbEntUpd

C++

int acdbEntUpd(
    const ads_name ent
);

File

acedads.h

Description

Updates the screen image of the specified entity. It redraws the entire entity; for complex entities, this includes subentities such as polyline vertices or block attributes. If ent specifies a subentity, acdbEntUpd() finds the head before it does the redraw.

This function is intended for use with complex entities, but it can be called to redraw any graphical entity in the current drawing database. Do not pass nongraphical objects, such as a symbol table, to acdbEntUpd().

Warning If ent is in a block definition, then acdbEntUpd() is not sufficient. You must regenerate the drawing by invoking the AutoCAD REGEN command (with acedCmd() or acedCommand()) to ensure that all instances of the block references are updated.

If acdbEntUpd() succeeds, it returns RTNORM; otherwise, it returns RTERROR. When acdbEntUpd() fails, it sets the system variable ERRNO to a value that indicates the reason for the failure.

Parameters