SolidWorksMakroprogrammierung

Methode · FeatureManager

FeatureFillet3-Methode (FeatureManager)

Erzeugt eine Verrundung an den ausgewählten Kanten, heute vor allem für Verrundungen mit veränderlichem Radius.

Syntax

Function FeatureFillet3( _
   ByVal Options As Long, _
   ByVal R1 As Double, _
   ByVal R2 As Double, _
   ByVal Rho As Double, _
   ByVal Ftyp As Long, _
   ByVal OverflowType As Long, _
   ByVal ConicRhoType As Long, _
   ByVal Radii As Variant, _
   ByVal Dist2Arr As Variant, _
   ByVal RhoArr As Variant, _
   ByVal SetBackDistances As Variant, _
   ByVal PointRadiusArray As Variant, _
   ByVal PointDist2Array As Variant, _
   ByVal PointRhoArray As Variant _
) As Object
Set swFeat = swFeatMgr.FeatureFillet3(nOptionen, 0, 0, 0, swFeatureFilletType_VariableRadius, swFilletOverFlowType_Default, _
        swFeatureFilletCircular, vRadien, Empty, Empty, Empty, vPunktRadien, Empty, Empty)

Parameter

OptionsLongByVal
Optionen, Werte aus swFeatureFilletOptions_e addiert, etwa swFeatureFilletPropagate (1) für tangentiale Fortsetzung oder swFeatureFilletAsymmetric (16384) für unterschiedliche Abstände.
R1DoubleByVal
Bei konstantem Radius der Radius in Metern, bei asymmetrischer Verrundung Abstand 1. Gilt nicht bei veränderlichem Radius.
R2DoubleByVal
Bei asymmetrischer Verrundung Abstand 2 in Metern. Gilt nicht bei veränderlichem Radius.
RhoDoubleByVal
Bei Kegelschnitt-Profil der Rho-Wert (0,05 bis 0,95) oder der Kegelschnitt-Radius. Gilt nicht bei veränderlichem Radius.
FtypLongByVal
Art der Verrundung, ein Wert aus swFeatureFilletType_e, hier meist swFeatureFilletType_VariableRadius (1).
OverflowTypeLongByVal
Verhalten, wenn die Verrundung über benachbarte Flächen läuft, ein Wert aus swFilletOverFlowType_e.
ConicRhoTypeLongByVal
Querschnitt der Verrundung, ein Wert aus swFeatureFilletProfileType_e, etwa swFeatureFilletCircular (0). Gilt nicht mit swFeatureFilletCurvatureContinuous.
RadiiVariantByVal
Nur bei veränderlichem Radius: Array mit einem Radius je Eckpunkt der ausgewählten Kanten, bei asymmetrischer Verrundung Abstand 1 (zwei Kanten mit gemeinsamer Ecke brauchten drei Werte, drei Kanten an einer Ecke vier; mit einem Wert je Kante lieferte die Methode Nothing).
Dist2ArrVariantByVal
Nur bei veränderlichem, asymmetrischem Radius: Array mit Abstand 2 je Kante.
RhoArrVariantByVal
Nur bei veränderlichem Radius und Kegelschnitt-Profil: Array mit Rho-Werten oder Kegelschnitt-Radien je Kante.
SetBackDistancesVariantByVal
Array mit den Rücksetzabständen an einer ausgewählten Ecke, an der mehrere verrundete Kanten zusammenkommen.
PointRadiusArrayVariantByVal
Nur bei veränderlichem Radius: Array mit den Radien an den Kontrollpunkten entlang der Kanten, bei asymmetrischer Verrundung Abstand 1.
PointDist2ArrayVariantByVal
Nur bei veränderlichem, asymmetrischem Radius: Array mit Abstand 2 an den Kontrollpunkten.
PointRhoArrayVariantByVal
Nur bei veränderlichem Radius und Kegelschnitt-Profil: Array mit Rho-Werten oder Radien an den Kontrollpunkten.

Rückgabewert

Das neue Feature.

Beispiel

' Verrundet die ausgewählten Kanten mit 2 mm, über CreateDefinition statt FeatureFillet3.
' Vorbedingung: In einem Teil sind Kanten ausgewählt (Markierung 1, siehe Bemerkungen).
' Ergebnis:     Ein neues Feature "Verrundung".
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeatMgr As SldWorks.FeatureManager
    Dim swDaten As SldWorks.SimpleFilletFeatureData2
    Dim swFeat As SldWorks.Feature

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swFeatMgr = swModel.FeatureManager

    Set swDaten = swFeatMgr.CreateDefinition(swFmFillet)
    swDaten.Initialize swConstRadiusFillet
    swDaten.ConicTypeForCrossSectionProfile = swFeatureFilletCircular
    swDaten.DefaultRadius = 0.002
    swDaten.OverflowType = swFilletOverFlowType_Default
    Set swFeat = swFeatMgr.CreateFeature(swDaten)
    If swFeat Is Nothing Then swApp.SendMsgToUser2 "Verrundung fehlgeschlagen.", swMbWarning, swMbOk
End Sub

Bemerkungen

Seit SOLIDWORKS 2020 ist FeatureFillet3 veraltet für Verrundungen mit konstantem Radius, Flächen- und Vollrundverrundungen, Teilverrundungen und alle Fasen. Dafür nimmst du FeatureManager.CreateDefinition mit swFmFillet, SimpleFilletFeatureData2 und FeatureManager.CreateFeature, wie im Beispiel. Wichtig bleibt FeatureFillet3 für Verrundungen mit veränderlichem Radius.

Für eine Verrundung mit veränderlichem Radius wählst du mit ModelDocExtension.SelectByID2 die Kanten mit der Markierung 1 aus und die Kontrollpunkte entlang der Kanten mit 256, einen je Wert in PointRadiusArray. Alle Arrays wachsen mit der Zahl der Kanten. Stimmen Länge oder Reihenfolge nicht, schlägt der Befehl fehl. Wie genau die Einträge den Kanten und Punkten zugeordnet werden, beschreibt die Hilfe nicht Stück für Stück. Am sichersten nimmst du die Verrundung mit dem Makrorekorder auf und passt dann die Zahlen an.

Rho-Werte außerhalb von 0,05 bis 0,95 setzt SOLIDWORKS auf den nächsten gültigen Wert. Rücksetzabstände gibst du an, indem du zusätzlich den Eckpunkt mit der Markierung 0 auswählst. Längen sind in Metern.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2015

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

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