Objekt · SldWorks
EndCapFeatureData-Objekt
Die Definition einer Endkappe an einem Strukturbauteil einer Schweißkonstruktion: Dicke, Richtung, Randabstand, Eckenbehandlung und die abgedeckte Fläche.
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
Feature.GetDefinition: bei einem Feature mit dem TypnamenEndCap
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| ChamferDistance | Liest oder setzt die Länge der Fase oder den Radius der Verrundung an den Ecken der Endkappe. |
| DepthDistance | Liest oder setzt den Einsatzabstand der Endkappe, also wie weit sie in das Strukturbauteil hinein versetzt ist. |
| Face | Liest oder setzt die Endfläche des Strukturbauteils, die die Endkappe abdeckt. |
| IsEndCapInward | Liest oder setzt, in welche Richtung die Dicke der Endkappe aufgetragen wird: nach außen, nach innen oder eingesetzt. |
| OffsetDistance | Liest oder setzt den Randabstand der Endkappe als festen Wert. |
| Thickness | Liest oder setzt die Dicke der Endkappe. |
| ThicknessRatioForOffset | Liest oder setzt den Randabstand der Endkappe als Verhältnis zur Wandstärke des Strukturbauteils. |
| UseChamferCorners | Liest oder setzt, ob die Ecken der Endkappe gefast oder verrundet werden. |
| UseCornerTreatment | Liest oder setzt, ob die Ecken der Endkappe eine Eckenbehandlung bekommen, also gefast oder verrundet werden. |
| UseReverse | Liest oder setzt, ob der Randabstand der Endkappe umgekehrt wird. |
| UseThicknessRatioForOffset | Liest oder setzt, ob der Randabstand der Endkappe als Verhältnis zur Wandstärke oder als fester Wert angegeben ist. |
Methoden 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Endkappe zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| ReleaseSelectionAccess | Hebt 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.