Hide Table of Contents
InsertPicture Method (ISketchManager)
Referenced image

Inserts a Referenced image.

.NET Syntax

Visual Basic (Declaration) 
Function InsertPicture( _
   const dsString& PathName As System.String, _
   double InsertX As System.Double, _
   double InsertY As System.Double, _
   double InsertZ As System.Double, _
   double Scale As System.Double, _
   double Rotation As System.Double _
) As ReferenceImage
ReferenceImage InsertPicture( 
   System.string PathName,
   System.double InsertX,
   System.double InsertY,
   System.double InsertZ,
   System.double Scale,
   System.double Rotation
   PathName : String,
   InsertX : Number,
   InsertY : Number,
   InsertZ : Number,
   Scale : Number,
   Rotation : Number
) : dsReferenceImage
COM native C++ 
HRESULT InsertPicture( 
   BSTR PathName,
   DOUBLE InsertX,
   DOUBLE InsertY,
   DOUBLE InsertZ,
   DOUBLE Scale,
   DOUBLE Rotation,
   IReferenceImage** Pic
DSRESULT InsertPicture( 
   const dsString& PathName,
   double InsertX,
   double InsertY,
   double InsertZ,
   double Scale,
   double Rotation,
   dsReferenceImage** Pic


Path and file name of the Referenced image to insert
x coordinate where to insert the Referenced image
y coordinate where to insert the Referenced image
z coordinate where to insert the Referenced image
Scale factor for each axis
Angle by which to rotate the Referenced image (see Remarks)
Pic[out] or Return Value
Referenced image


This code snippet shows how to insert a Referenced image.

COM native C++

bstr_t imageFileName ( L"<path_and file_name_of_image>" );

double insertX = 0, insertY = 0, insertZ = 0, scale = 1, rotation = 0;

ReferenceImagePtr imageEntity = sketchMgr->InsertPicture( imageFileName, insertX, insertY, insertZ, scale, rotation );




Use a positive value for Rotation to rotate the Referenced image counterclockwise and a negative value to rotate the Referenced image clockwise.

See Also


DraftSight V1R1

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

Subject:   Feedback on Help Topics
Page:   InsertPicture Method (ISketchManager)
*   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:


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

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.