SolidWorksMakroprogrammierung

Objekt · SldWorks

WeldmentTrimExtendFeatureData-Objekt

Die Definition eines Features „Trimmen/Verlängern“ in einer Schweißkonstruktion: Eckenart, zu trimmende Körper und Grenzen.

Deklaration Dim x As SldWorks.WeldmentTrimExtendFeatureData · in der englischen .NET-Hilfe: IWeldmentTrimExtendFeatureData

Beschreibung

WeldmentTrimExtendFeatureData gibt Zugriff auf die Daten eines Features „Trimmen/Verlängern“ (trim/extend) einer Schweißkonstruktion. Trimmen und verlängern lassen sich nur Körper, die Schweißkonstruktions-Features erzeugt haben. Die Befehle gibt es seit SOLIDWORKS 2006.

Zugriff

Neu anlegen kannst du das Feature mit FeatureManager.InsertWeldmentTrimFeature2.

Beispiel

' Geht den FeatureManager durch und gibt für jedes Feature „Trimmen/Verlängern“
' die Eckenart, die Zahl der Körper und die Art der Grenzen aus.
' Vorbedingung: Ein Schweißteil ist offen, etwa weldment_box3.sldprt aus den Beispielen.
' Ergebnis:     Die Angaben stehen im Direktfenster, 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.WeldmentTrimExtendFeatureData
    Dim nGrenzArt As Long
    Dim vGrenzen As Variant

    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 = "WeldCornerFeat" Then
            Set swDaten = swFeat.GetDefinition
            If swDaten.AccessSelections(swModel, Nothing) Then
                Select Case swDaten.CornerType
                    Case swEndConditionMiter: Debug.Print swFeat.Name & ": Gehrung"
                    Case swEndConditionButt1: Debug.Print swFeat.Name & ": Stumpfstoß 1"
                    Case swEndConditionButt2: Debug.Print swFeat.Name & ": Stumpfstoß 2"
                    Case swEndConditionTrim:  Debug.Print swFeat.Name & ": Endtrimmung"
                End Select
                Debug.Print "  Körper zum Trimmen: " & swDaten.GetBodiesToBeTrimmedCount
                vGrenzen = swDaten.GetTrimmingBoundary(nGrenzArt)
                Debug.Print "  Grenzen: " & swDaten.GetTrimmingBoundaryCount & _
                            IIf(nGrenzArt = swSelFACES, " Flächen", " Körper")
                swDaten.ReleaseSelectionAccess
            End If
        End If
        Set swFeat = swFeat.GetNextFeature
    Loop
End Sub

Bemerkungen

Eckenarten: Nur die Endtrimmung (swEndConditionTrim) kann mehrere zu trimmende Körper und mehrere Grenzen haben, auch Flächen als Grenzen. Alle anderen Eckenarten haben genau einen Körper und eine Grenze. Gibst du dort mehr an, nimmt SOLIDWORKS den ersten gültigen.

Ändern: Nach WeldmentTrimExtendFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du WeldmentTrimExtendFeatureData.ReleaseSelectionAccess auf. Änderst du die Eckenart, musst du auch die zu trimmenden Körper und die Grenzen neu setzen.

Hilfebeispiel: Das Beispiel „Get Weldment Trim Extend Corner Type“ läuft durch den FeatureManager von weldment_box3.sldprt und gibt für jedes Feature vom Typ WeldCornerFeat die Eckenart als Zahl aus. Es ruft dafür AccessSelections nicht auf.

Mehr dazu: Die Hilfe verweist bei mehreren Befehlen auf das Thema „Accessing Selections that Define Features“.

Eigenschaften und Methoden

Eigenschaften 2, davon 2 beschrieben

NameBeschreibung
BodiesToBeTrimmedLiest oder setzt die Körper, die das Feature „Trimmen/Verlängern“ trimmt.
CornerTypeLiest oder setzt die Eckenart des Features „Trimmen/Verlängern“: Gehrung, Stumpfstoß oder Endtrimmung.

Methoden 6, davon 6 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Trimmen/Verlängern“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetBodiesToBeTrimmedCountLiefert die Zahl der Körper, die das Feature „Trimmen/Verlängern“ trimmt.
GetTrimmingBoundaryLiefert die Körper oder Flächen, die die Grenzen des Features „Trimmen/Verlängern“ bilden.
GetTrimmingBoundaryCountLiefert die Zahl der Grenzen des Features „Trimmen/Verlängern“.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Trimmen/Verlängern“ nicht geändert hast.
SetTrimmingBoundarySetzt die Körper oder Flächen, die die Grenzen des Features „Trimmen/Verlängern“ bilden.

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

Siehe auch

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

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