SolidWorksMakroprogrammierung

Objekt · SldWorks

SimpleFilletFeatureData2-Objekt

Die Definition einer Verrundung mit konstantem Radius, einer Flächenverrundung oder einer vollständigen Rundung: Elemente, Radien, Profil, Rücksetzabstände und Teilkanten.

Deklaration Dim x As SldWorks.SimpleFilletFeatureData2 · in der englischen .NET-Hilfe: ISimpleFilletFeatureData2

Beschreibung

SimpleFilletFeatureData2 gibt Zugriff auf eine einfache Verrundung. Dazu zählen drei Arten aus swSimpleFilletType_e: die Verrundung mit konstantem Radius, die Flächenverrundung und die vollständige Rundung (full round fillet). Mit dem Querschnittsprofil swFeatureFilletConicRhoZeroChamfer legst du über dasselbe Objekt auch eine Fase mit Flächenversatz oder eine Fase zwischen zwei Flächen an. Eine Verrundung kann symmetrisch sein (ein Radius) oder asymmetrisch (Abstand 1 und Abstand 2). Die ältesten Befehle gibt es seit SOLIDWORKS 2001Plus, die für kegelige und asymmetrische Verrundungen seit 2014 und 2015, die für Teilkanten seit 2020.

Zugriff

Beispiel

' Gibt Art, Profil und Radien der ausgewählten Verrundung aus und vergrößert den
' vorgegebenen Radius um 1 mm.
' Vorbedingung: Ein Teil mit einer Verrundung mit konstantem Radius ist offen, die
'               Verrundung ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, der Radius ist 1 mm größer.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.SimpleFilletFeatureData2
    Dim swElement As Object
    Dim i As Integer

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "Fillet" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": Art " & swDaten.Type & ", Profil " & swDaten.ConicTypeForCrossSectionProfile & _
                ", " & IIf(swDaten.AsymmetricFillet, "asymmetrisch", "symmetrisch")
    Debug.Print "Vorgabe: " & swDaten.DefaultRadius * 1000 & " mm, " & swDaten.GetEdgeCount & " Kanten"
    If swDaten.IsMultipleRadius Then
        For i = 0 To swDaten.FilletItemsCount - 1
            Set swElement = swDaten.GetFilletItemAtIndex(i)
            If Not swElement Is Nothing Then
                Debug.Print "Element " & i & ": " & swDaten.GetRadius(swElement) * 1000 & " mm"
            End If
        Next i
    End If

    If swDaten.Type = swConstRadiusFillet And False = swDaten.IsMultipleRadius Then
        swDaten.DefaultRadius = swDaten.DefaultRadius + 0.001
        If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
    Else
        swDaten.ReleaseSelectionAccess
    End If
End Sub

Bemerkungen

Anlegen: Mit FeatureManager.CreateDefinition und swFmFillet holst du eine neue Definition und rufst SimpleFilletFeatureData2.Initialize mit swConstRadiusFillet, swFaceFillet oder swFullRoundFillet auf. Dann legst du mit SimpleFilletFeatureData2.ConicTypeForCrossSectionProfile das Profil fest. Vor FeatureManager.CreateFeature wählst du mit ModelDocExtension.SelectByID2 aus:

  • Verrundung mit konstantem Radius oder Fase mit Flächenversatz: Kanten, Flächen, Features oder Schleifen mit der Markierung 1; dazu setzt du SimpleFilletFeatureData2.OverflowType
  • Flächenverrundung oder Fase zwischen zwei Flächen: Flächensatz 1 mit 2, Flächensatz 2 mit 4, Haltelinien mit 8
  • vollständige Rundung: Flächensatz 1 mit 2, mittlerer Flächensatz mit 512, Flächensatz 2 mit 4

Das Hilfebeispiel zum Objekt legt so eine asymmetrische Flächenverrundung an, das Beispiel zu PartialEdgeFilletData eine Fase auf Teilkanten.

Ändern: Nach SimpleFilletFeatureData2.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du SimpleFilletFeatureData2.ReleaseSelectionAccess auf.

Was wann gilt: Steht SimpleFilletFeatureData2.CurvatureContinuous auf True, gelten SimpleFilletFeatureData2.RoundCorners und das Querschnittsprofil nicht. Mehrere Radien (SimpleFilletFeatureData2.IsMultipleRadius) gibt es nur bei symmetrischen Verrundungen mit konstantem Radius und symmetrischen Fasen mit Flächenversatz.

Einheiten: Für Radien und Abstände nennt die Hilfe keine Einheit. Es sind wie sonst in der API Meter, das Hilfebeispiel setzt 0.01 und 0.02.

Mehr dazu: Die Hilfe verweist auf die Themen „Fillets“, „Constant Size Fillets“, „Face Fillets“, „Full Round Fillets“ und den PropertyManager „Chamfer“ in der Hilfe zur Oberfläche und bei vielen Befehlen auf „Accessing Selections that Define Features“.

Eigenschaften und Methoden

Eigenschaften 24, davon 24 beschrieben

NameBeschreibung
AsymmetricFilletLiest oder setzt, ob die Verrundung oder Fase asymmetrisch ist, also mit Abstand 1 und Abstand 2 statt einem Radius.
ConicTypeForCrossSectionProfileLiest oder setzt das Querschnittsprofil: kreisförmig, Kegelschnitt mit Rho-Wert oder Radius, oder Fase.
ConstantWidthLiest oder setzt, ob die Verrundung eine konstante Breite hat.
CurvatureContinuousLiest oder setzt, ob die Verrundung krümmungsstetig in die Nachbarflächen übergeht.
DefaultConicRhoOrRadiusLiest oder setzt den vorgegebenen Rho-Wert oder Kegelschnitt-Radius der Verrundung.
DefaultDistanceLiest oder setzt den vorgegebenen Abstand 2 einer asymmetrischen Verrundung oder Fase.
DefaultRadiusLiest oder setzt den vorgegebenen Radius einer symmetrischen Verrundung oder den Abstand 1 einer asymmetrischen.
EdgesLiest oder setzt die Kanten, die mit konstantem Radius verrundet werden.
EnablePartialEdgeParametersLiest oder setzt, ob die Verrundung auf allen Kanten Teilkanten-Einstellungen zulässt.
FeaturesLiest oder setzt die Features, deren Kanten verrundet werden.
FilletItemsCountLiefert die Zahl der Elemente einer Verrundung mit mehreren Radien.
HelpPointLiest oder setzt den Hilfspunkt, der bei einer Flächenverrundung oder Fase zwischen zwei Flächen die Seite festlegt.
HoldLinesLiest oder setzt die Haltelinien (Begrenzungen) einer Flächenverrundung.
IsMultipleRadiusLiest oder setzt, ob die symmetrische Verrundung oder Fase mehrere Radien hat, also je Element einen eigenen.
KeepFeaturesLiest oder setzt, ob vorhandene Features auf den verrundeten Elementen erhalten bleiben.
LoopsLiest oder setzt die Schleifen, deren Kanten verrundet werden.
OmitAttachedEdgesLiest, ob die Verrundung die Anschlusskanten des Features auslässt.
OverflowTypeLiest oder setzt, wie sich die Verrundung verhält, wenn sie auf Nachbarflächen überläuft.
PropagateFeatureToPartsLiest oder setzt, ob die Verrundung in einer Baugruppe auf alle betroffenen Teile übertragen wird.
PropagateToTangentFacesLiest oder setzt, ob die Verrundung auf alle tangential anschließenden Flächen fortgesetzt wird.
ReverseFaceNormalLiest oder setzt die Option „Flächennormale umkehren“ für einen Flächensatz einer Flächenverrundung zwischen Flächenkörpern.
RoundCornersLiest oder setzt, ob die Ecken der Verrundung gerundet werden.
TrimAndAttachSurfacesLiest oder setzt, ob eine Flächenverrundung an Flächenkörpern die Flächen trimmt und zusammenfügt.
TypeLiefert die Art der Verrundung: konstanter Radius, Flächenverrundung oder vollständige Rundung.

Methoden 26, davon 26 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Verrundung zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetConicRhoOrRadiusLiefert den Rho-Wert oder Kegelschnitt-Radius an einem Element der Verrundung.
GetDistanceLiefert Abstand 2 an einem Element einer asymmetrischen Verrundung oder Fase.
GetEdgeCountLiefert die Zahl der Kanten, die mit konstantem Radius verrundet werden.
GetFaceCountLiefert die Zahl der Flächen in einem Flächensatz der Verrundung.
GetFacesLiefert die Flächen eines Flächensatzes der Verrundung.
GetFeatureCountLiefert die Zahl der Features, deren Kanten verrundet werden.
GetFilletItemAtIndexLiefert ein Element einer Verrundung mit mehreren Radien: eine Kante, Fläche oder Schleife.
GetHoldLineCountLiefert die Zahl der Haltelinien einer Flächenverrundung.
GetLoopCountLiefert die Zahl der Schleifen, deren Kanten verrundet werden.
GetPartialEdgeFilletDataLiefert die Teilkanten-Einstellungen einer Kante der Verrundung.
GetRadiusLiefert den Radius einer symmetrischen Verrundung oder Abstand 1 einer asymmetrischen an einem Element.
GetSetbackDistanceCountLiefert die Zahl der Rücksetzabstände an einem Eckpunkt, also auch die Zahl der Kanten dort.
GetSetbackVertexDistanceLiefert die Rücksetzabstände und die zugehörigen Kanten an einem Eckpunkt.
GetSetbackVerticesLiefert die Eckpunkte, an denen die Verrundung Rücksetzabstände hat.
GetSetbackVerticesCountLiefert die Zahl der Eckpunkte mit Rücksetzabständen.
InitializeBereitet eine neue Definition auf eine Art vor: konstanter Radius, Flächenverrundung oder vollständige Rundung.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Verrundung nicht geändert hast.
RepairMissingReferencesSucht fehlende Bezüge der Verrundung oder Fase und weist sie neuen Kanten zu.
SetConicRhoOrRadiusSetzt den Rho-Wert oder Kegelschnitt-Radius an einem Element der Verrundung.
SetDistanceSetzt Abstand 2 an einem Element einer asymmetrischen Verrundung oder Fase.
SetFacesSetzt die Flächen eines Flächensatzes der Verrundung.
SetPartialEdgeFilletDataSetzt die Teilkanten-Einstellungen einer Kante der Verrundung oder entfernt sie.
SetRadiusSetzt den Radius einer symmetrischen Verrundung oder Abstand 1 einer asymmetrischen an einem Element.
SetSetbackVertexDistanceSetzt die Rücksetzabstände auf den Kanten an einem Eckpunkt, an dem mehrere Verrundungen zusammenkommen.
SetSetbackVerticesLegt die Eckpunkte fest, an denen die Verrundung Rücksetzabstände hat.

Nicht aufgeführt sind 20 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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