Hide Table of Contents
HoleWizard5 Method (IFeatureManager)

Creates a hole or slot using the Hole Wizard.

.NET Syntax

Visual Basic (Declaration) 
Function HoleWizard5( _
   ByVal GenericHoleType As System.Integer, _
   ByVal StandardIndex As System.Integer, _
   ByVal FastenerTypeIndex As System.Integer, _
   ByVal SSize As System.String, _
   ByVal EndType As System.Short, _
   ByVal Diameter As System.Double, _
   ByVal Depth As System.Double, _
   ByVal Length As System.Double, _
   ByVal Value1 As System.Double, _
   ByVal Value2 As System.Double, _
   ByVal Value3 As System.Double, _
   ByVal Value4 As System.Double, _
   ByVal Value5 As System.Double, _
   ByVal Value6 As System.Double, _
   ByVal Value7 As System.Double, _
   ByVal Value8 As System.Double, _
   ByVal Value9 As System.Double, _
   ByVal Value10 As System.Double, _
   ByVal Value11 As System.Double, _
   ByVal Value12 As System.Double, _
   ByVal ThreadClass As System.String, _
   ByVal RevDir As System.Boolean, _
   ByVal FeatureScope As System.Boolean, _
   ByVal AutoSelect As System.Boolean, _
   ByVal AssemblyFeatureScope As System.Boolean, _
   ByVal AutoSelectComponents As System.Boolean, _
   ByVal PropagateFeatureToParts As System.Boolean _
) As Feature
Visual Basic (Usage) 
Dim instance As IFeatureManager
Dim GenericHoleType As System.Integer
Dim StandardIndex As System.Integer
Dim FastenerTypeIndex As System.Integer
Dim SSize As System.String
Dim EndType As System.Short
Dim Diameter As System.Double
Dim Depth As System.Double
Dim Length As System.Double
Dim Value1 As System.Double
Dim Value2 As System.Double
Dim Value3 As System.Double
Dim Value4 As System.Double
Dim Value5 As System.Double
Dim Value6 As System.Double
Dim Value7 As System.Double
Dim Value8 As System.Double
Dim Value9 As System.Double
Dim Value10 As System.Double
Dim Value11 As System.Double
Dim Value12 As System.Double
Dim ThreadClass As System.String
Dim RevDir As System.Boolean
Dim FeatureScope As System.Boolean
Dim AutoSelect As System.Boolean
Dim AssemblyFeatureScope As System.Boolean
Dim AutoSelectComponents As System.Boolean
Dim PropagateFeatureToParts As System.Boolean
Dim value As Feature
 
value = instance.HoleWizard5(GenericHoleType, StandardIndex, FastenerTypeIndex, SSize, EndType, Diameter, Depth, Length, Value1, Value2, Value3, Value4, Value5, Value6, Value7, Value8, Value9, Value10, Value11, Value12, ThreadClass, RevDir, FeatureScope, AutoSelect, AssemblyFeatureScope, AutoSelectComponents, PropagateFeatureToParts)
C# 
Feature HoleWizard5( 
   System.int GenericHoleType,
   System.int StandardIndex,
   System.int FastenerTypeIndex,
   System.string SSize,
   System.short EndType,
   System.double Diameter,
   System.double Depth,
   System.double Length,
   System.double Value1,
   System.double Value2,
   System.double Value3,
   System.double Value4,
   System.double Value5,
   System.double Value6,
   System.double Value7,
   System.double Value8,
   System.double Value9,
   System.double Value10,
   System.double Value11,
   System.double Value12,
   System.string ThreadClass,
   System.bool RevDir,
   System.bool FeatureScope,
   System.bool AutoSelect,
   System.bool AssemblyFeatureScope,
   System.bool AutoSelectComponents,
   System.bool PropagateFeatureToParts
)
C++/CLI 
Feature^ HoleWizard5( 
&   System.int GenericHoleType,
&   System.int StandardIndex,
&   System.int FastenerTypeIndex,
&   System.String^ SSize,
&   System.short EndType,
&   System.double Diameter,
&   System.double Depth,
&   System.double Length,
&   System.double Value1,
&   System.double Value2,
&   System.double Value3,
&   System.double Value4,
&   System.double Value5,
&   System.double Value6,
&   System.double Value7,
&   System.double Value8,
&   System.double Value9,
&   System.double Value10,
&   System.double Value11,
&   System.double Value12,
&   System.String^ ThreadClass,
&   System.bool RevDir,
&   System.bool FeatureScope,
&   System.bool AutoSelect,
&   System.bool AssemblyFeatureScope,
&   System.bool AutoSelectComponents,
&   System.bool PropagateFeatureToParts
) 

Parameters

GenericHoleType
Type of hole or slot as defined in swWzdGeneralHoleTypes_e
StandardIndex
Hole or slot standard property as defined in swWzdHoleStandards_e
FastenerTypeIndex
Hole or slot fastener type as defined in swWzdHoleStandardFastenerTypes_e
SSize
Size of the hole or slot
EndType
Hole or slot end type as defined in swEndConditions_e
Diameter
Diameter of the hole or slot
Depth
Depth of the hole or slot
Length

Length of slot and valid only when GenericHoleType set to:

  • swWzdGeneralHoleTypes_e.swWzdCounterBoreSlot
  • swWzdGeneralHoleTypes_e.swWzdCounterSinkSlot
  • swWzdGeneralHoleTypes_e.swWzdHoleSlot
Value1
Hole or slot parameter
Value2
Hole or slot parameter
Value3
Hole or slot parameter
Value4
Hole or slot parameter
Value5
Hole or slot parameter
Value6
Hole or slot parameter
Value7
Hole or slot parameter
Value8
Hole or slot parameter
Value9
Hole or slot parameter
Value10
Hole or slot parameter
Value11
Hole or slot parameter
Value12
Hole or slot parameter
ThreadClass

One of the following thread classes:

  • 1B

  • 2B

  • 3B

NOTE: Applies to ANSI inch standard only.

RevDir

True to reverse the direction of the hole or slot, false to not

FeatureScope
True if the feature only affects selected bodies, false if the feature affects all bodies
AutoSelect
True to automatically select all bodies and have the feature affect those bodies, false to select the bodies the feature affects
AssemblyFeatureScope
True if the assembly feature only affects selected components in the assembly, false if the assembly feature affects all components in the assembly
AutoSelectComponents
True to automatically select all affected components, false to only use the selected components
PropagateFeatureToParts
True to propagate the assembly feature to the components that the assembly feature affects in the model, false to not

Return Value

Feature

Example

Remarks

Valid types of slots are counterbore, countersink, or straight.

To add a hole or slot at multiple locations, preselect the sketch points and do not specify any selection marks.

Before creating a hole or slot using a reference plane and IFeatureManager::HoleWizard5, determine the value of the RevDir parameter as follows:

  • If the material is on one side of the reference plane, then RevDir is false.
  • If the material is on both sides of the reference plane, then compare the distances between the reference plane and the material on both sides. If the distance between the reference plane and the material along its normal direction is bigger, then RevDir is true; otherwise, RevDir is false.

You can also use IModelDoc2::RayIntersections and IModelDoc2::GetRayIntersectionsPoints to find out if the material is on one side or both sides and to compare the distances.

The screw fit is defined as swWzdHoleScrewClearanceTypes_e and is only used if a hole or slot diameter is not specified; default value is NORMAL_FIT. The drill angle defaults to 118, if not specified. Input angles are in radians; input values are in meters.

Parameters for this method:

  • The FastenerTypeIndex parameter has to match the standard and be valid for that hole or slot type, or an error occurs.

  • The SSize parameter must be a valid size for the fastener type, or an error occurs.

  • The Value1 through Value12 parameters are different for each type of hole or slot. The possible values are as follows, organized by hole and slot type. SOLIDWORKS ignores parameters set to -1.

Counterbore Holes and Slots

Head clearance - Added to either the input counterbore depth or the counterbore depth in the standard.

Parameters for all counterbore holes and counterbore slots:

  1. CounterBore Diameter
  2. CounterBore Depth
  3. HeadClearance
  4. Screw Fit
  5. Drill Angle
  6. Near Csink Diameter
  7. Near Csink Angle
  8. Bot Csink Diameter
  9. Bot Csink Angle
  10. Far Csink Diameter
  11. Far Csink Angle
  12. Offset

Countersink Holes and Slots

Head clearance type - Value from swWzdHoleCounterSinkHeadClearanceTypes_e, which represents how to add the head clearance values to the hole or slot.

Parameters for all countersink holes and countersink slots:

  1. Near Csink Diameter
  2. Near Csink Angle
  3. Head Clearance
  4. Screw Fit
  5. Drill Angle
  6. Far Csink Diameter
  7. Far Csink Angle
  8. Offset
  9. Head Clearance Type

Regular Holes and Straight Slots

Parameters for all regular holes and straight slots:

  1. Screw Fit
  2. Drill Angle
  3. Near Csink Diameter
  4. Near Csink Angle
  5. Far Csink Diameter
  6. Far Csink Angle
  7. Offset

Pipe Tapped Holes

Tap Drill Depth - Depth can be set up as a ratio from the standard thread depth or the input thread depth. If the user does specify a tap drill depth, then the calculation from the thread depth is replaced with the specified depth.

Cosmetic Thread Type - Defaults to swCosmeticThreadNone as defined in swWzdHoleCosmeticThreadTypes_e.

Near countersink angle - Can be calculated from standard data as a default.

Parameters for all ptap holes:

  1. Thread Depth
  2. Near Csink Diameter
  3. Near Csink Angle
  4. Far Csink Diameter
  5. Far Csink Angle
  6. Drill Angle
  7. Cosmetic Thread Type
  8. Offset

Tap Holes

Tap Drill Depth - If the user specifies a tap drill depth, then SOLIDWORKS always uses this depth. Tap drill depths can be calculated:

  • Helicoil holes: Tap drill depth is calculated based on a constant * tap drill diameter + allowance for tap type (bottoming or plug).
  • Tapped holes: Tap drill depth is calculated from the thread length + advance + allowance for tap type (bottoming or plug).

Thread Depth - If the user specifies thread depth, SOLIDWORKS always uses this depth. Tap drill depths can be calculated:

  • Helicoil holes: Thread depth is calculated based on a constant (determined by hole type; i.e., insert = 1.0 * diameter) + thread depth from the standard * thread major diameter.

  • Tapped holes: based on 2 * thread diameter.

Cosmetic Thread Type - Specified as defined in swWzdHoleCosmeticThreadTypes_e

Hcoil Tap Type - Defaults to swTapTypePlug as defined in swWzdHoleHcoilTapTypes_e; used only for the helicoil standard holes

Thread end condition - Defaults to swEndThreadTypeBLIND as defined in swWzdHoleThreadEndCondition_e

Parameters for all ptap holes:

  1. Tap drill diameter
  2. Tap drill depth
  3. Thread Depth
  4. Near Csink Diameter
  5. Near Csink Angle
  6. Far Csink Diameter
  7. Far Csink Angle
  8. Drill Angle
  9. Cosmetic Thread Type
  10. Thread End Condition
  11. Helicoil Tap Type
  12. Offset

Legacy Holes

For legacy types of holes, StandardIndex, FastenerTypeIndex, and SSize are:

  • Not relevant
  • SOLIDWORKS ignores them

The sequence of parameters 6 to 19 for different types of legacy holes is as follows:

Simple

  1. Diameter
  2. Depth
  3. Sketch ID

Tapered

  1. Minor Diameter
  2. Depth
  3. Sketch ID
  4. Major Diameter

Counterbored

  1. Diameter
  2. Depth
  3. Sketch ID
  4. C-Bore Diameter
  5. C-Bore Depth

Countersunk

  1. Diameter
  2. Depth
  3. Sketch ID
  4. C-Sink Angle
  5. C-Sink Diameter

Counterdrilled

  1. Diameter
  2. Depth
  3. Sketch ID
  4. C-Drill Diameter
  5. C-Drill Depth
  6. C-Drill Angle

Simple Drilled

  1. Diameter
  2. Depth
  3. Sketch ID
  4. Drill Angle

Tapered Drilled

  1. Minor Diameter
  2. Depth
  3. Sketch ID
  4. Major Diameter
  5. Drill Angle

C-Bored Drilled

  1. Diameter
  2. Depth
  3. Sketch ID
  4. C-Bore Diameter
  5. C-Bore Depth
  6. Drill Angle

C-Sunk Drilled

  1. Diameter
  2. Depth
  3. Sketch ID
  4. C-Sink Diameter
  5. C-Sink Angle
  6. Drill Angle

C-Drilled Drilled

  1. Diameter
  2. Depth
  3. Sketch ID
  4. C-Drill Diameter
  5. C-Drill Depth
  6. Drill Angle
  7. C-Drill Angle
 

See Also

Availability

SOLIDWORKS 2014 FCS, Revision Number 22.0


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:   HoleWizard5 Method (IFeatureManager)
*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) 2017 SP05

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.