VCAddLineEntity


Version:

1.2

Description:

Adds a line entity to the drawing database or to a symbol definition.

Declaration:

 

C/C++

extern "C" void WINAPI VCAddLineEntity(short* iError, short iSymbolIndex, Point2D dpP0, Point2D dpP1);
extern "C" void WINAPI VCAddLineEntityBP(short* iError, short iSymbolIndex, Point2D* dpP0, Point2D* dpP1);

Delphi

procedure VCAddLineEntityBP(var iError: Smallint; iSymbolIndex: Smallint; dpP0: Point2D; var dpP1: Point2D); stdcall;

ActiveX/COM

Sub AddLineEntity(ByVal iSymbolIndex As Integer, dpP0 As IVCPoint2D, dpP1 As IVCPoint2D)

Parameters:

iSymbolIndex - index location for adding the entity.
-1 - NONDEFENTITY (Drawing)
-2 - HATCHFILLENTITY
> 0 - Use VCGetSymbolIndex to retrieve the symbol index for creating a symbol definition.
dpP0
- the Point2D structure containing the coordinates of the first endpoint.
dpP1
- the Point2D structure containing the coordinates of the second endpoint.

Notes:

Any entity added to the Visual CADD™ drawing database or to a symbol definition will take on the current properties for line type, color, layer, and width. These properties should be set before adding the entity or they may be changed after creation with the change commands. All point locations including those within a symbol definition are relative to the drawing origin. Each entity added will be appended to the end of the database and take on the entity handle of one higher than the last entity in the drawing before the addition. To add entities to a symbol definition, the index of an existing symbol is retrieved with VCGetSymbolIndex while VCCreateSymbolDef creates an empty definition for a new symbol.

See Also:

VCAddLine3D, VCAddLineType, VCGetSymbolIndex, VCCreateSymbolDef