SolidWorksMakroprogrammierung

Methode · FeatureManager

AdvancedHole2-Methode (FeatureManager)

Erzeugt eine erweiterte Bohrung aus gestapelten Elementen wie Senkung, Bohrung und Gewinde.

Syntax

Function AdvancedHole2( _
   ByVal AdvancedHoleNearElementArray As Variant, _
   ByVal AdvancedHoleFarElementArray As Variant, _
   ByVal UseBaselineDimensions As Boolean, _
   ByVal IsCustomCallout As Boolean, _
   ByVal IsDepthUptoTip As Boolean, _
   ByRef ResultArray As Variant _
) As Feature
Set swFeat = swFeatMgr.AdvancedHole2(vNah, vFern, False, False, False, vErgebnis)

Parameter

AdvancedHoleNearElementArrayVariantByVal
Array mit den Elementen von der nahen Seite aus, in der Reihenfolge, in der sie von der Fläche nach innen folgen.
AdvancedHoleFarElementArrayVariantByVal
Array mit den Elementen von der fernen Seite aus. Leer, wenn die Bohrung nur von einer Seite kommt.
UseBaselineDimensionsBooleanByVal
True: Bezugsbemaßungen verwenden. Das bestimmt, welche Eigenschaften der Elemente gelten.
IsCustomCalloutBooleanByVal
True: eigene Bohrungsbeschriftung, die du bei jedem Element mit AdvancedHoleElementData.CalloutString setzt. False: Standardbeschriftung.
IsDepthUptoTipBooleanByVal
True: die Tiefe reicht bis zur Bohrerspitze. False: bis zur Schulter, also die volle Tiefe der zylindrischen Bohrung.
ResultArrayVariantByRef · Rückgabe
Gibt ein Array mit einem Ergebnis je Element zurück, Werte aus swAdvancedHoleResults_e.

Rückgabewert

Das neue Feature, oder Nothing, wenn die Bohrung nicht entstehen konnte.

Beispiel

' swFeatMgr ist der FeatureManager eines Teils. vNah und vFern sind Arrays mit Elementdaten,
' die nahe und die ferne Fläche sind mit SelectByRay ausgewählt (siehe Bemerkungen).
Dim swFeat As SldWorks.Feature
Dim vErgebnis As Variant
Dim i As Long
Set swFeat = swFeatMgr.AdvancedHole2(vNah, vFern, False, False, False, vErgebnis)
If swFeat Is Nothing Then
    Debug.Print "Keine Bohrung erzeugt."
    If Not IsEmpty(vErgebnis) Then
        For i = 0 To UBound(vErgebnis)
            If vErgebnis(i) <> swAdvancedHoleResults_Success Then Debug.Print "Element " & i & ": Fehler " & vErgebnis(i)
        Next i
    End If
End If

Bemerkungen

Die erweiterte Bohrung ist unabhängig von der Bohrungsassistent-Funktion (FeatureManager.HoleWizard5) und funktioniert nur in Teilen. Die Schritte:

  1. Mit ModelDocExtension.SelectByRay die nahe Fläche (Markierung 256) und die ferne Fläche (Markierung 512) auswählen. Die Hilfe verlangt eine Auswahl über die Lage, also nicht mit Entity.Select4.
  2. Für jedes Element mit ModelDocExtension.CreateAdvancedHoleElementData ein Datenobjekt erzeugen und die allgemeinen Werte über AdvancedHoleElementData setzen.
  3. Die besonderen Werte über das passende Objekt setzen: CounterboreElementData, CountersinkElementData, StraightElementData, StraightTapElementData oder TaperedTapElementData.
  4. Die Objekte in zwei Arrays legen, je von der Fläche nach innen. Die innersten Elemente beider Seiten sollen sich zu einer durchgehenden Bohrung treffen.
  5. AdvancedHole2 aufrufen.

IsDepthUptoTip = True geht nur, wenn es keine Elemente auf der fernen Seite gibt und das letzte Element der nahen Seite eine Bohrung oder ein gerades Gewinde mit Bohrerspitze und der Endbedingung „Blind“ oder „Abstand von Fläche“ ist.

Auch wenn alle Einträge in ResultArray Erfolg melden, kann das Ergebnis Nothing sein: wenn die Elemente zusammen keine gültige Geometrie ergeben oder die Flächen falsch ausgewählt sind. Die Bohrung sitzt zunächst an einer Stelle. Weitere Stellen erzeugst du, indem du den Skizzenpunkt der Bohrung löschst und mit SketchManager.CreatePoint neue setzt. Zum Ändern holst du mit Feature.GetDefinition das AdvancedHoleFeatureData.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2020

Englisches Original: IFeatureManager::AdvancedHole2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.