DXFReaderNETControlAddInsert Method
|
Adds a new insert entity to the current drawing.
Namespace:
DXFReaderNET
Assembly:
DXFReaderNET (in DXFReaderNET.dll) Version: 20.12.2
Syntaxpublic EntityObject AddInsert(
string BlockName,
Vector3 Position,
double Rotation = 0,
Vector3 Scale = default,
short ACIColor = 256,
string LayerName = "",
string LineTypeName = "",
bool AddToDrawing = true
)
Public Function AddInsert (
BlockName As String,
Position As Vector3,
Optional Rotation As Double = 0,
Optional Scale As Vector3 = Nothing,
Optional ACIColor As Short = 256,
Optional LayerName As String = "",
Optional LineTypeName As String = "",
Optional AddToDrawing As Boolean = true
) As EntityObject
public:
EntityObject^ AddInsert(
String^ BlockName,
Vector3 Position,
double Rotation = 0,
Vector3 Scale = Vector3(),
short ACIColor = 256,
String^ LayerName = L"",
String^ LineTypeName = L"",
bool AddToDrawing = true
)
member AddInsert :
BlockName : string *
Position : Vector3 *
?Rotation : float *
?Scale : Vector3 *
?ACIColor : int16 *
?LayerName : string *
?LineTypeName : string *
?AddToDrawing : bool
(* Defaults:
let _Rotation = defaultArg Rotation 0
let _Scale = defaultArg Scale new Vector3()
let _ACIColor = defaultArg ACIColor 256
let _LayerName = defaultArg LayerName ""
let _LineTypeName = defaultArg LineTypeName ""
let _AddToDrawing = defaultArg AddToDrawing true
*)
-> EntityObject
METHOD AddInsert(
BlockName AS STRING,
Position AS Vector3,
Rotation AS REAL8 := 0,
Scale AS Vector3 := new Vector3(),
ACIColor AS SHORT := 256,
LayerName AS STRING := "",
LineTypeName AS STRING := "",
AddToDrawing AS LOGIC := TRUE
) AS EntityObject
Parameters
- BlockName
- Type: SystemString
The block name - Position
- Type: DXFReaderNETVector3
The position of the insert entity. - Rotation (Optional)
- Type: SystemDouble
The rotation in degree of the insert entity. - Scale (Optional)
- Type: DXFReaderNETVector3
A vector with scaling along x, y and z (Default value: [1,1,1]). - ACIColor (Optional)
- Type: SystemInt16
A number for 0 to 256 corresponding to the AutoCAD Color Index (0 = ByBlock; 256 = ByLayer. Default value = 256). - LayerName (Optional)
- Type: SystemString
The layer name. If omitted, or layername doesn't exist, the CurrentLayer will be used. - LineTypeName (Optional)
- Type: SystemString
The linetype name. If omitted, or linetype doesn't exist, the CurrentLineTypeName will be used. - AddToDrawing (Optional)
- Type: SystemBoolean
If true, the entity will be added to the drawing. Determines whether the created entity should actually be added to the current drawing or database. If false, the method just creates and returns the EntityObject without inserting it into the drawing. Useful when you want to preview, modify, or combine it with other entities before committing.
Return Value
Type:
EntityObjectThe new added
Insert.
RemarksThe entity is added to the active layout.
See Also