SolidWorksMakroprogrammierung

Objekt · SldWorks

CornerReliefFeatureData-Objekt

Die Definition eines Eckfreischnitts im Blech: Blechkörper, Art der Ecken und die einzelnen Ecken mit ihrer Freischnittform.

Deklaration Dim x As SldWorks.CornerReliefFeatureData · in der englischen .NET-Hilfe: ICornerReliefFeatureData

Beschreibung

CornerReliefFeatureData gibt Zugriff auf das Feature eines Eckfreischnitts im Blech. Es schneidet an Ecken frei, an denen zwei oder drei Biegungen zusammentreffen. Jede Ecke ist ein SMCornerReliefData mit eigener Freischnittform, etwa rechteckig, kreisförmig oder als Riss. Die meisten Befehle liefern einen Fehlercode aus swCornerReliefError_e. Die Befehle gibt es seit SOLIDWORKS 2022.

Zugriff

Beispiel

' Legt für den ausgewählten Blechkörper einen Eckfreischnitt an, der alle Ecken mit zwei
' Biegungen rechteckig freischneidet.
' Vorbedingung: Ein Blechteil mit Ecken aus zwei Biegungen ist offen, etwa mit skizzierten
'               Biegungen. Der Blechkörper ist ausgewählt.
' Ergebnis:     Ein neuer Eckfreischnitt im FeatureManager.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeatMgr As SldWorks.FeatureManager
    Dim swBody As SldWorks.Body2
    Dim swDaten As SldWorks.CornerReliefFeatureData
    Dim swEcke As SldWorks.SMCornerReliefData
    Dim swFeat As SldWorks.Feature
    Dim vEcken As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swBody = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If swBody Is Nothing Then Exit Sub
    Set swFeatMgr = swModel.FeatureManager

    Set swDaten = swFeatMgr.CreateDefinition(swFmCornerRelief)
    If False = swDaten.Initialize(swCornerReliefBendType_TwoBend) Then Exit Sub
    If swDaten.SetBodyScope(swBody) <> swCornerReliefError_None Then
        Debug.Print "Kein gültiger Blechkörper"
        Exit Sub
    End If
    If swDaten.CollectAllCorners(swCornerTearRelief, vEcken) <> swCornerReliefError_None Then Exit Sub

    For i = 0 To UBound(vEcken)
        Set swEcke = vEcken(i)
        swEcke.ReliefType = swCornerRectangularRelief
        swEcke.RatioToThickness = True                         ' Größe im Verhältnis zur Blechstärke
    Next i
    Set swFeat = swFeatMgr.CreateFeature(swDaten)
    If swFeat Is Nothing Then
        Debug.Print "Nicht angelegt"
    Else
        Debug.Print swFeat.Name & " mit " & UBound(vEcken) + 1 & " Ecken"
    End If
End Sub

Bemerkungen

Anlegen: Wie im Hilfebeispiel zu CornerReliefFeatureData holst du die Definition mit FeatureManager.CreateDefinition, rufst CornerReliefFeatureData.Initialize und CornerReliefFeatureData.SetBodyScope auf, sammelst die Ecken mit CornerReliefFeatureData.CollectAllCorners, stellst ihre Form ein und legst das Feature mit FeatureManager.CreateFeature an.

Ändern: Wie im Hilfebeispiel holst du die Definition mit Feature.GetDefinition, rufst CornerReliefFeatureData.AccessSelections auf, holst die Ecken mit GetCorners(-1), änderst sie und rufst Feature.ModifyDefinition auf.

Index ab 1: CornerReliefFeatureData.GetCornerAtIndex und CornerReliefFeatureData.RemoveCorner zählen die Ecken ab 1, das Array aus GetCorners und CollectAllCorners beginnt wie üblich bei 0.

Typname: Welchen Typnamen das Feature in Feature.GetTypeName2 hat, nennt die Hilfe nicht.

An einer Blechschale aus ModelDoc2.InsertFeatureShell, ModelDoc2.InsertRip und PartDoc.InsertBends2 liefern Initialize True und SetBodyScope swCornerReliefError_None, CollectAllCorners aber den Fehler 2 ohne Ecken.

Eigenschaften und Methoden

Eigenschaften 2, davon 2 beschrieben

NameBeschreibung
CornerCountLiefert die Zahl der Ecken im Eckfreischnitt-Feature.
CornerTypeLiefert, ob der Eckfreischnitt an Ecken mit zwei oder mit drei Biegungen ansetzt.

Methoden 10, davon 10 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor den Eckfreischnitt zurück, damit du Körper und Ecken lesen und ändern kannst.
AddNewCornerFügt dem Eckfreischnitt eine Ecke hinzu, festgelegt durch zwei oder drei Flächen, mit einer Freischnittform.
CollectAllCornersLegt für alle Ecken des gewählten Blechkörpers je eine Ecke mit derselben Freischnittform an.
GetBodyScopeLiefert den Blechkörper, auf den der Eckfreischnitt wirkt.
GetCornerAtIndexLiefert eine Ecke des Eckfreischnitts über ihren Index, der bei 1 beginnt.
GetCornersLiefert alle Ecken des Eckfreischnitts mit einer bestimmten Freischnittform oder mit allen Formen.
InitializeLegt bei einer neuen Definition fest, ob der Eckfreischnitt an Ecken mit zwei oder mit drei Biegungen ansetzt.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du den Eckfreischnitt nicht geändert hast.
RemoveCornerEntfernt eine Ecke aus dem Eckfreischnitt über ihren Index, der bei 1 beginnt.
SetBodyScopeLegt den Blechkörper fest, auf den der Eckfreischnitt wirkt.

Siehe auch

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

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