Function AdvancedHole( _
   ByVal AdvancedHoleNearElementArray As System.Object, _
   ByVal AdvancedHoleFarElementArray As System.Object, _
   ByVal UseBaselineDimensions As System.Boolean, _
   ByVal IsCustomCallout As System.Boolean, _
   ByRef ResultArray As System.Object _
) As Feature

Dim instance As IFeatureManager
Dim AdvancedHoleNearElementArray As System.Object
Dim AdvancedHoleFarElementArray As System.Object
Dim UseBaselineDimensions As System.Boolean
Dim IsCustomCallout As System.Boolean
Dim ResultArray As System.Object
Dim value As Feature
 
value = instance.AdvancedHole(AdvancedHoleNearElementArray, AdvancedHoleFarElementArray, UseBaselineDimensions, IsCustomCallout, ResultArray)

Feature AdvancedHole( 
   System.object AdvancedHoleNearElementArray,
   System.object AdvancedHoleFarElementArray,
   System.bool UseBaselineDimensions,
   System.bool IsCustomCallout,
   out System.object ResultArray
)

Feature^ AdvancedHole( 
&   System.Object^ AdvancedHoleNearElementArray,
&   System.Object^ AdvancedHoleFarElementArray,
&   System.bool UseBaselineDimensions,
&   System.bool IsCustomCallout,
&   [Out] System.Object^ ResultArray
) 

Parameters

AdvancedHoleNearElementArray

Array of near side hole data objects (see Remarks)

AdvancedHoleFarElementArray

Array of far side hole data objects (see Remarks)

UseBaselineDimensions

True to use baseline dimensions, false to not (see Remarks)

IsCustomCallout

True to customize the hole callout, false to use a default hole callout (see Remarks)

ResultArray

Array of result codes as defined in swAdvancedHoleResults_e (see Remarks)

Return Value

The Advanced Hole feature:

AdvancedHoleNearElementArray and AdvancedHoleFarElementArray each contain one or more hole type-specific objects in order as they stack from the near and far side faces:

• ICounterboreElementData
• ICountersinkElementData
• IStraightElementData
• IStraightTapElementData
• ITaperedTapElementData

The hole type-specific interfaces above extend the parent interface, IAdvancedHoleElementData, which you use to set general Advanced Hole properties.

UseBaseLineDimensions controls which hole type-specific properties are valid. See IAdvancedHoleFeatureData::UseBaselineDimensions.

IsCustomCallout set to true allows you to set a custom callout string for individual hole elements using IAdvancedHoleElementData::CalloutString.

ResultArray contains a return code for each element in AdvancedHoleNearElementArray and AdvancedHoleFarElementArray. It is possible for this method to fail to create an advanced hole, even though ResultArray contains all success result codes. If the individual hole elements all combine to produce invalid geometry (e.g., a disjoint body or a self-intersecting face) or if incorrect near or far side faces are selected, then this method returns Nothing or null.

To create an Advanced Hole feature, follow the examples which do the following:

1. Call IModelDocExtension::SelectByRay to select the near side (Mark = 256) and far side (Mark = 512) faces of the Advanced Hole. You must select these faces by location, so do not use IEntity::Select4.
2. Call IModelDocExtension::CreateAdvancedHoleElementData to create an AdvancedHoleElementData object.
3. Set the general Advanced Hole properties using the AdvancedHoleElementData object.
4. Cast the AdvancedHoleElementData object using one of the hole type-specific interfaces.
5. Set the specific Advanced Hole properties using the hole type-specific object.
6. Repeat steps 2 - 5 for each hole element you want to add to the near and far side stacks of the Advanced Hole.
7. Create near and far side arrays of the hole type-specific objects in stacking order from each face inward. The innermost elements of each stack should match to create a contiguous hole that extends from near side face to far side face.
8. Pass the near and far side arrays to IFeatureManager::AdvancedHole to create the Advanced Hole.
9. Delete the defining Advanced Hole sketch point and call ISketchManager::CreatePoint one or more times to insert the Advanced Hole in multiple locations.

To edit an Advanced Hole feature, call IFeature::GetDefinition to access IAdvancedHoleFeatureData. See Accessing Selections that Define Features.