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 FeatureSet 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.
UseBaselineDimensionsBooleanByValTrue: Bezugsbemaßungen verwenden. Das bestimmt, welche Eigenschaften der Elemente gelten.IsCustomCalloutBooleanByValTrue: eigene Bohrungsbeschriftung, die du bei jedem Element mitAdvancedHoleElementData.CalloutStringsetzt.False: Standardbeschriftung.IsDepthUptoTipBooleanByValTrue: 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 IfBemerkungen
Die erweiterte Bohrung ist unabhängig von der Bohrungsassistent-Funktion (FeatureManager.HoleWizard5) und funktioniert nur in Teilen. Die Schritte:
- Mit
ModelDocExtension.SelectByRaydie nahe Fläche (Markierung256) und die ferne Fläche (Markierung512) auswählen. Die Hilfe verlangt eine Auswahl über die Lage, also nicht mitEntity.Select4. - Für jedes Element mit
ModelDocExtension.CreateAdvancedHoleElementDataein Datenobjekt erzeugen und die allgemeinen Werte überAdvancedHoleElementDatasetzen. - Die besonderen Werte über das passende Objekt setzen:
CounterboreElementData,CountersinkElementData,StraightElementData,StraightTapElementDataoderTaperedTapElementData. - 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.
- 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.