SolidWorksMakroprogrammierung

Objekt · SldWorks

EndCapFeatureData-Objekt

Die Definition einer Endkappe an einem Strukturbauteil einer Schweißkonstruktion: Dicke, Richtung, Randabstand, Eckenbehandlung und die abgedeckte Fläche.

Deklaration Dim x As SldWorks.EndCapFeatureData · in der englischen .NET-Hilfe: IEndCapFeatureData

Beschreibung

EndCapFeatureData gibt Zugriff auf ein Feature „Endkappe“ (end cap). Eine Endkappe schließt das offene Ende eines Strukturbauteils (StructuralMemberFeatureData) in einer Schweißkonstruktion mit einer Platte. Die ersten Befehle gibt es seit SOLIDWORKS 2005, die Dickenrichtung, den Einsatzabstand, die Eckenbehandlung und das Umkehren seit SOLIDWORKS 2015.

Zugriff

Neu anlegen kannst du eine Endkappe mit FeatureManager.InsertEndCapFeature3 oder FeatureManager.InsertEndCapFeature2.

Beispiel

' Geht den FeatureManager durch und gibt für jede Endkappe Dicke, Richtung,
' Randabstand, Eckenbehandlung und die Größe der abgedeckten Fläche aus.
' Vorbedingung: Ein Schweißteil mit Endkappen ist offen, etwa weldment_box3.sldprt aus den Beispielen.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G), das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.EndCapFeatureData
    Dim swFace As SldWorks.Face2

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

    Set swFeat = swModel.FirstFeature
    Do While Not swFeat Is Nothing
        If swFeat.GetTypeName2 = "EndCap" Then
            Set swDaten = swFeat.GetDefinition
            Debug.Print swFeat.Name & ": Dicke " & swDaten.Thickness * 1000 & " mm"
            Select Case swDaten.IsEndCapInward
                Case swExtendOutward: Debug.Print "  nach außen"
                Case swExtendInward:  Debug.Print "  nach innen"
                Case swSpecifyInset:  Debug.Print "  eingesetzt um " & swDaten.DepthDistance * 1000 & " mm"
            End Select
            If swDaten.UseThicknessRatioForOffset Then
                Debug.Print "  Randabstand: " & swDaten.ThicknessRatioForOffset & " x Wandstärke"
            Else
                Debug.Print "  Randabstand: " & swDaten.OffsetDistance * 1000 & " mm"
            End If
            If swDaten.UseCornerTreatment Then
                Debug.Print "  " & IIf(swDaten.UseChamferCorners, "Fase ", "Verrundung ") & _
                    swDaten.ChamferDistance * 1000 & " mm"
            End If
            If swDaten.AccessSelections(swModel, Nothing) Then
                Set swFace = swDaten.Face
                If Not swFace Is Nothing Then
                    Debug.Print "  Endfläche: " & Format(swFace.GetArea * 1000000, "0.0") & " mm²"
                End If
                swDaten.ReleaseSelectionAccess
            End If
        End If
        Set swFeat = swFeat.GetNextFeature
    Loop
End Sub

Bemerkungen

Begriffe: Die Namen der Eigenschaften passen nicht zu den Parametern von FeatureManager.InsertEndCapFeature3. Die Dicke der Kappe heißt dort Depth, hier EndCapFeatureData.Thickness. Der Einsatzabstand heißt dort DepthOffset, hier EndCapFeatureData.DepthDistance. Das Hilfebeispiel „Insert Weldment End Cap“ gibt DepthDistance als „Inset distance“ aus.

Einheiten: Die Hilfe nennt bei den Eigenschaften keine Einheit. Die Hilfebeispiele rechnen Dicke, Randabstand, Einsatzabstand und Fase mit * 1000 in Millimeter um, die Werte sind also Meter.

Ändern: Nach EndCapFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du EndCapFeatureData.ReleaseSelectionAccess auf. Die Hilfe verweist bei EndCapFeatureData.Face auf das Thema „Accessing Selections that Define Features“.

Mehrere Flächen: FeatureManager.InsertEndCapFeature3 kann mehrere Endflächen auf einmal abdecken. EndCapFeatureData.Face liefert eine Fläche. Welche das bei mehreren Flächen ist, sagt die Hilfe nicht.

Hilfebeispiele: „Insert Weldment End Cap“ fügt in weldment_box3.sldprt eine Endkappe ein und gibt ihre Werte aus, die Fläche ausgenommen. „List End-Cap Feature Properties“ liest die Eigenschaften einer ausgewählten Endkappe und wählt die abgedeckte Fläche aus.

Bei einer Endkappe mit der Richtung swSpecifyInset liefert EndCapFeatureData.DepthDistance 0, nicht den beim Einfügen übergebenen Einsatzabstand DepthOffset.

Eigenschaften und Methoden

Eigenschaften 11, davon 11 beschrieben

NameBeschreibung
ChamferDistanceLiest oder setzt die Länge der Fase oder den Radius der Verrundung an den Ecken der Endkappe.
DepthDistanceLiest oder setzt den Einsatzabstand der Endkappe, also wie weit sie in das Strukturbauteil hinein versetzt ist.
FaceLiest oder setzt die Endfläche des Strukturbauteils, die die Endkappe abdeckt.
IsEndCapInwardLiest oder setzt, in welche Richtung die Dicke der Endkappe aufgetragen wird: nach außen, nach innen oder eingesetzt.
OffsetDistanceLiest oder setzt den Randabstand der Endkappe als festen Wert.
ThicknessLiest oder setzt die Dicke der Endkappe.
ThicknessRatioForOffsetLiest oder setzt den Randabstand der Endkappe als Verhältnis zur Wandstärke des Strukturbauteils.
UseChamferCornersLiest oder setzt, ob die Ecken der Endkappe gefast oder verrundet werden.
UseCornerTreatmentLiest oder setzt, ob die Ecken der Endkappe eine Eckenbehandlung bekommen, also gefast oder verrundet werden.
UseReverseLiest oder setzt, ob der Randabstand der Endkappe umgekehrt wird.
UseThicknessRatioForOffsetLiest oder setzt, ob der Randabstand der Endkappe als Verhältnis zur Wandstärke oder als fester Wert angegeben ist.

Methoden 2, davon 2 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Endkappe zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Endkappe nicht geändert hast.

Siehe auch

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

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