Hide Table of Contents
InsertBlock2 Method (ISketchManager)
Blk[out]
Block instance

Inserts a Block instance.

.NET Syntax

Visual Basic (Declaration) 
Function InsertBlock2( _
   const dsString& BlockName As System.String, _
   double InsertX As System.Double, _
   double InsertY As System.Double, _
   double InsertZ As System.Double, _
   double ScaleX As System.Double, _
   double ScaleY As System.Double, _
   double ScaleZ As System.Double, _
   double Rotation As System.Double _
) As BlockInstance
C# 
BlockInstance InsertBlock2( 
   System.string BlockName,
   System.double InsertX,
   System.double InsertY,
   System.double InsertZ,
   System.double ScaleX,
   System.double ScaleY,
   System.double ScaleZ,
   System.double Rotation
)
JavaScript 
InsertBlock2( 
   BlockName : String,
   InsertX : Number,
   InsertY : Number,
   InsertZ : Number,
   ScaleX : Number,
   ScaleY : Number,
   ScaleZ : Number,
   Rotation : Number
) : dsBlockInstance
COM native C++ 
HRESULT InsertBlock2( 
   BSTR BlockName,
   DOUBLE InsertX,
   DOUBLE InsertY,
   DOUBLE InsertZ,
   DOUBLE ScaleX,
   DOUBLE ScaleY,
   DOUBLE ScaleZ,
   DOUBLE Rotation,
   IBlockInstance** Blk
) 
C++ 
DSRESULT InsertBlock2( 
   const dsString& BlockName,
   double InsertX,
   double InsertY,
   double InsertZ,
   double ScaleX,
   double ScaleY,
   double ScaleZ,
   double Rotation,
   dsBlockInstance** Blk
) 

Parameters

BlockName
Name for the Block instance
InsertX
x coordinate where to insert the Block instance
InsertY
y coordinate where to insert the Block instance
InsertZ
z coordinate where to insert the Block instance
ScaleX
Scale factor for the x axis
ScaleY
Scale factor for the y axis
ScaleZ
Scale factor for the z axis
Rotation
Angle, in radians, by which to rotate the Block instance (see Remarks)
Blk[out] or Return Value
Block instance

Example

This code snippet shows how to insert a Block instance.

COM native C++

//Insert the existing Block instance or insert Block instance from a DWG file

 

bstr_t blockFileName ( L"<path_and_DWG_file_name_OR_existing_Block_name>" );

double insertX = 0, insertY = 0, insertZ = 0, scaleX = 1, scaleY = 1, scaleZ = 1, rotation = 0;

BlockInstancePtr blockInstance = sketchMgr->InsertBlock2( blockFileName, insertX, insertY, insertZ, scaleX, scaleY, scaleZ, rotation );

Example

Remarks

Before calling this method, you can call ICommandMessage::PromptForBlockInsertion if you want to prompt the user to specify how to insert the Block instance.

Use a positive value for Rotation to rotate the Block instance counterclockwise and a negative value to rotate the Block instance clockwise.

 

See Also

Availability

DraftSight V1R2.1


Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

 
*Email:  
Subject:   Feedback on Help Topics
Page:   InsertBlock2 Method (ISketchManager)
*Comment:  
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:



x

We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again
x

Web Help Content Version: API Help (English only) 2019 SP04

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.