Hide Table of Contents
InsertHatchByEntities Method (ISketchManager)

Inserts a Hatch with the specified pattern, scale, angle, and boundary defined by the specified entities.

.NET Syntax

Visual Basic (Declaration) 
Function InsertHatchByEntities( _
   const dsObjectPtrArray& EntitiesArray As System.Object, _
   const dsString& PatternName As System.String, _
   double PatternScale As System.Double, _
   double PatternAngle As System.Double _
) As Hatch
Hatch InsertHatchByEntities( 
   System.object EntitiesArray,
   System.string PatternName,
   System.double PatternScale,
   System.double PatternAngle
   EntitiesArray : Array,
   PatternName : String,
   PatternScale : Number,
   PatternAngle : Number
) : dsHatch
COM native C++ 
HRESULT InsertHatchByEntities( 
   VARIANT EntitiesArray,
   BSTR PatternName,
   DOUBLE PatternScale,
   DOUBLE PatternAngle,
   IHatch** Hatch
DSRESULT InsertHatchByEntities( 
   const dsObjectPtrArray& EntitiesArray,
   const dsString& PatternName,
   double PatternScale,
   double PatternAngle,
   dsHatch** Hatch


Array of entities that form the Hatch boundary

Name of the Hatch pattern


Value by which to scale the Hatch pattern; values are between .25 and 2 in .25 unit increments; default is 1 (see Remarks)


Angle of the Hatch pattern lines; values are between 0 and 2*pi radians in .26 radian increments; a positive angle rotates the pattern counter-clockwise

Hatch[out] or Return Value



If PatternScale is equal to:

  • 2.00, then the distance between pattern lines doubles. 
  • 0.25, then the distance between pattern lines is 1/4 the original distance.

PatternScale is valid only when the HatchPatternType parameter of IHatchPattern::GetHatchOrSolidData is not dsHatchPatternType_e.dsHatchPatternType_UserDefined.

To scale user-defined Hatch patterns, call IHatchPattern::SetHatchOrSolidData to change the line spacing of the Hatch pattern.


See Also


DraftSight V1R1.4

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:   InsertHatchByEntities 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.