VCTruncFrom


Version:

2.0

Description:

Truncates the database from the specified entity handle.

Declaration:

 

C/C++

extern "C" void WINAPI VCTruncFrom(short* iError, ENTITYHANDLE StartHere);

Delphi

procedure VCTruncFrom(var iError: Smallint; StartHere: Longint); stdcall;

ActiveX/COM

Sub TruncFrom(ByVal StartHere As Long)

Parameters:

StartHere - the entity handle for the entity to begin truncating from.

Notes:

The drawing database maintains all entity operation in the database. This includes erased entity information for undo and redo levels. This data is stored until a pack data command or save. In some situation however an application may need only to add an entity temporarily and not have it remain in the database for undo and redo operations. VCTruncFrom allows an application to truncate the database effectively eliminating items from the drawing and not allowing undo levels to get set. For example, an application may need to display a temporary construction line during operation. Since it is not desirable to maintain the entity in the drawing database the application can truncate the drawing from that point.

See Also:

VCClearDrawing, VCClearDrawingNoPrompt, VCPackData, VCPurgeErasedEntities