SolidWorksMakroprogrammierung

Objekt · SldWorks

ComplexCornerTreatmentFeatureData-Objekt

Die Definition einer komplexen Ecke in einem Tragwerk, an der sich drei oder mehr Elemente treffen.

Deklaration Dim x As SldWorks.ComplexCornerTreatmentFeatureData · in der englischen .NET-Hilfe: IComplexCornerTreatmentFeatureData

Beschreibung

ComplexCornerTreatmentFeatureData gibt Zugriff auf eine komplexe Eckenbehandlung eines Tragwerks. Eine komplexe Ecke ist die Stelle, an der sich drei oder mehr Elemente treffen. Ein Element kann als Trimmwerkzeug an den angrenzenden Elementen Material hinzufügen oder entfernen. Die übrigen Elemente werden nach ihrer Trimmreihenfolge und ihrer Lage zu den berührenden Elementen getrimmt, entweder am Körper oder eben. Die Befehle mit eigener Hilfeseite gibt es seit SOLIDWORKS 2023.

Zugriff

Beispiel

' Geht alle Eckenverwaltungen des Teils durch und gibt für jede komplexe Ecke das
' Trimmwerkzeug und die Elemente aus, die am Körper oder eben getrimmt werden.
' Vorbedingung: Ein Teil mit einem Tragwerk und mindestens einer komplexen Ecke ist offen.
' Ergebnis:     Die komplexen Ecken stehen im Direktfenster. Das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swOrdnerFeat As SldWorks.Feature
    Dim swVerwaltung As SldWorks.CornerManagementFolder
    Dim swGruppe As SldWorks.CornerTreatmentGroupFolder
    Dim swEckFeat As SldWorks.Feature
    Dim swDaten As SldWorks.CornerTreatmentFeatureData
    Dim swKomplex As SldWorks.ComplexCornerTreatmentFeatureData
    Dim vOrdner As Variant, vGruppen As Variant, vEcken As Variant
    Dim i As Long, k As Long, x As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocPART Then Exit Sub

    vOrdner = swModel.FeatureManager.GetCornerManagementFolders
    If Not IsArray(vOrdner) Then Exit Sub
    For i = 0 To UBound(vOrdner)
        Set swOrdnerFeat = vOrdner(i)
        Set swVerwaltung = swOrdnerFeat.GetSpecificFeature2
        vGruppen = swVerwaltung.GetTreatmentGroupFolders
        If IsArray(vGruppen) Then
            For k = 0 To UBound(vGruppen)
                Set swGruppe = vGruppen(k)
                vEcken = swGruppe.GetCornerTreatments
                If IsArray(vEcken) Then
                    For x = 0 To UBound(vEcken)
                        Set swEckFeat = vEcken(x)
                        Set swDaten = swEckFeat.GetDefinition
                        If swDaten.CornerType = swCorner_Complex Then
                            swDaten.AccessSelections swModel, Nothing
                            Set swKomplex = swDaten                      ' dieselbe Definition
                            Debug.Print swEckFeat.Name
                            EckeAusgeben swKomplex
                            swDaten.ReleaseSelectionAccess               ' nichts geändert
                        End If
                    Next x
                End If
            Next k
        End If
    Next i
End Sub

Private Sub EckeAusgeben(swKomplex As SldWorks.ComplexCornerTreatmentFeatureData)
    Dim swElement As SldWorks.CornerMember
    Dim swWerkzeug As Object
    Dim vListe As Variant
    Dim nArt As Long, i As Long

    Set swWerkzeug = swKomplex.GetTrimToolMember(nArt)
    If swWerkzeug Is Nothing Then
        Debug.Print "  Kein Trimmwerkzeug"
    ElseIf nArt = swTrimToolMemberObjectType_swCornerMember Then
        Set swElement = swWerkzeug
        Debug.Print "  Trimmwerkzeug: " & swElement.GetUnderlyingMemberFeature.Name
    Else
        Debug.Print "  Trimmwerkzeug: Feature " & swWerkzeug.Name
    End If

    vListe = swKomplex.GetBodyTrimMembers
    If IsArray(vListe) Then
        For i = 0 To UBound(vListe)
            Set swElement = vListe(i)
            Debug.Print "  Am Körper getrimmt: " & swElement.GetUnderlyingMemberFeature.Name & _
                        ", Reihenfolge " & swElement.TrimOrder
        Next i
    End If

    vListe = swKomplex.GetPlanarTrimMembers
    If IsArray(vListe) Then
        For i = 0 To UBound(vListe)
            Set swElement = vListe(i)
            Debug.Print "  Eben getrimmt: " & swElement.GetUnderlyingMemberFeature.Name
        Next i
    End If

    If swKomplex.PlanarTrimToolType = swCornerTreatmentPlanarTrimTool_Automatic Then
        Debug.Print "  Ebenes Trimmen automatisch, Option " & swKomplex.PlanarTrimOption
    Else
        Debug.Print "  Ebenes Trimmen an selbst gewählten Flächen"
    End If
End Sub

Bemerkungen

Abgeleitete Schnittstelle: ComplexCornerTreatmentFeatureData ist von CornerTreatmentFeatureData abgeleitet und gilt nur, wenn deren IgnoreCornerTreatment False ist. AccessSelections, ReleaseSelectionAccess und CornerType rufst du wie im Hilfebeispiel „Access Structure System Corner Treatments“ an der CornerTreatmentFeatureData auf, die übrigen Befehle an derselben Definition als ComplexCornerTreatmentFeatureData.

Fünf Listen: Der PropertyManager zeigt für komplexe Ecken fünf Listen: die Eckgruppen, das Trimmwerkzeug, die Elemente mit Trimmen am Körper, die Elemente mit ebenem Trimmen und die selbst gewählten Trimmflächen. Die Eckgruppen erreichst du über CornerTreatmentGroupFolder, die übrigen Listen über dieses Objekt.

Ändern: Nach AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition mit der CornerTreatmentFeatureData auf. Schlägt das fehl oder änderst du nichts, rufst du ReleaseSelectionAccess auf. So macht es auch das Hilfebeispiel.

Ohne eigene Hilfeseite: PlanarTrimToolType, UserDefinedTrimFaces, GetBodyTrimMembers, GetPlanarTrimMembers, SetBodyTrimMembers und SetPlanarTrimMembers beschreibt die Hilfe nur in der Liste der Befehle. Die Angaben dazu stützen sich auf das Hilfebeispiel und sind dort als Annahmen gekennzeichnet, wo das Beispiel sie nicht zeigt.

Profilordner: CreateStructureSystem lieferte Nothing, solange der Ordner für Schweißprofile in den Optionen auf einen fehlenden Ordner zeigte. Mit dem Ordner …\SOLIDWORKS\data\weldment profiles entstand das Tragwerk.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
PlanarTrimOptionLiest oder setzt, wo die komplexe Ecke beim automatischen ebenen Trimmen schneidet: beim ersten oder beim vollständigen Kontakt.
PlanarTrimToolTypeLiest oder setzt, ob die komplexe Ecke automatisch oder an selbst gewählten Flächen eben trimmt.
UserDefinedTrimFacesLiest oder setzt die selbst gewählten Flächen, an denen die komplexe Ecke eben trimmt.

Methoden 6, davon 6 beschrieben

NameBeschreibung
GetBodyTrimMembersLiefert die Elemente der komplexen Ecke, die am Körper getrimmt werden.
GetPlanarTrimMembersLiefert die Elemente der komplexen Ecke, die eben getrimmt werden.
GetTrimToolMemberLiefert das Trimmwerkzeug der komplexen Ecke, ein Eckelement oder ein Feature.
SetBodyTrimMembersLegt fest, welche Elemente der komplexen Ecke am Körper getrimmt werden.
SetPlanarTrimMembersLegt fest, welche Elemente der komplexen Ecke eben getrimmt werden.
SetTrimToolMemberLegt das Trimmwerkzeug der komplexen Ecke fest, ein Eckelement oder ein Feature.

Siehe auch

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

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