SolidWorksMakroprogrammierung

Objekt · SldWorks

CosmeticWeldBeadFeatureData-Objekt

Die Definition einer kosmetischen Schweißnaht: Größe, Seiten, Teillänge, unterbrochene Naht, Schweißsymbol und die geschweißten Flächen, Kanten oder Pfade.

Deklaration Dim x As SldWorks.CosmeticWeldBeadFeatureData · in der englischen .NET-Hilfe: ICosmeticWeldBeadFeatureData

Beschreibung

CosmeticWeldBeadFeatureData gibt Zugriff auf eine kosmetische Schweißnaht. Sie stellt eine Naht dar, ohne Geometrie hinzuzufügen, entweder zwischen zwei Gruppen von Flächen oder Kanten oder entlang eines Pfads aus Kanten und Skizzen. Die Nähte stehen im Ordner „Weld Folder“, gesammelt in Unterordnern (CosmeticWeldBeadFolder). Die meisten Befehle gibt es seit SOLIDWORKS 2013, die für Flächen, Kanten und Pfade seit 2015.

Zugriff

Beispiel

' Gibt Größe, Seiten, Teillänge und Angaben zur unterbrochenen Naht der ausgewählten
' kosmetischen Schweißnaht aus, dazu Material und Gesamtlänge ihres Ordners.
' Vorbedingung: Ein Teil mit einer kosmetischen Schweißnaht ist offen, die Naht ist im
'               FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.CosmeticWeldBeadFeatureData
    Dim swOrdner As SldWorks.CosmeticWeldBeadFolder

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "CosmeticWeldBead" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    swDaten.AccessSelections swModel, Nothing              ' lieferte in SOLIDWORKS 2024 False
    Debug.Print swFeat.Name & ": Größe " & swDaten.BeadSize * 1000 & " mm"
    If swDaten.TangentPropagation Then
        Debug.Print "  Tangentiale Fortsetzung"
    Else
        Debug.Print "  Seiten: " & swDaten.Side                    ' swCosmeticWeldBeadSide_e
    End If
    If swDaten.FromToLength Then
        Debug.Print "  Teillänge " & swDaten.FromToWeldLength * 1000 & " mm ab " & _
                    swDaten.FromToStartPoint * 1000 & " mm"                ' Meter
    End If
    If swDaten.IntermittentWeld Then
        Debug.Print "  Unterbrochen, Nahtstücke je " & swDaten.IntermittentWeldLength * 1000 & " mm"
    End If
    Set swOrdner = swDaten.GetWeldBeadFolder
    If Not swOrdner Is Nothing Then
        Debug.Print "  Ordner: Material " & swOrdner.Material & ", Gesamtlänge " & swOrdner.TotalLength
    End If
    swDaten.ReleaseSelectionAccess                             ' nichts geändert
End Sub

Bemerkungen

Abhängige Werte: Viele Eigenschaften gelten nur in bestimmten Kombinationen. Mit CosmeticWeldBeadFeatureData.TangentPropagation True nimmst du die Teillänge, mit False legst du CosmeticWeldBeadFeatureData.Side fest. Abstand, Teilung, Länge der Nahtstücke und Versatz gelten nur bei CosmeticWeldBeadFeatureData.IntermittentWeld True, der Versatz zusätzlich nur bei beidseitiger Naht.

Zwei Arten von Nähten: Nähte zwischen Geometrie haben Ausgangs- und Zielelemente (GetEntitiesWeldFrom und GetEntitiesWeldTo), Nähte entlang eines Pfads haben einen Pfad (GetEntitiesWeldPath). Welche Art beim Anlegen entsteht, legt der Modus bei FeatureManager.InsertCosmeticWeldBead2 fest.

Ändern: Nach CosmeticWeldBeadFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du CosmeticWeldBeadFeatureData.ReleaseSelectionAccess auf.

Einheiten: Größe, Teillänge, Abstand und Teilung sind Meter. Die Gesamtlänge im Ordner aus CosmeticWeldBeadFeatureData.GetWeldBeadFolder kam dagegen in Millimetern.

Veraltete Befehle: GetEntities und SetEntities sind veraltet. An ihre Stelle treten CosmeticWeldBeadFeatureData.GetEntitiesWeldFrom und CosmeticWeldBeadFeatureData.SetEntitiesWeldFrom.

Bei einer Naht entlang eines Pfads liefert CosmeticWeldBeadFeatureData.AccessSelections False, Änderungen übernimmt Feature.ModifyDefinition trotzdem; frag den Rückgabewert darum nicht ab. FeatureManager.InsertCosmeticWeldBead2 im Modus swCosmeticWeldBeadMode_WeldGeometry mit zwei Flächen liefert meist Empty.

Eigenschaften und Methoden

Eigenschaften 14, davon 14 beschrieben

NameBeschreibung
BeadSizeLiest oder setzt die Größe (Dicke) der kosmetischen Schweißnaht.
FromToLengthLiest oder setzt, ob die Schweißnaht nur auf einer Teillänge liegt, mit Startpunkt und Länge.
FromToReverseLiest oder setzt, ob die Teillänge der Schweißnaht am anderen Ende beginnt.
FromToStartPointLiest oder setzt, wo die Teillänge der Schweißnaht beginnt, gemessen vom Ende der Fläche oder Kante.
FromToWeldLengthLiest oder setzt die Länge der Schweißnaht ab dem Startpunkt.
GapLiest oder setzt den Abstand zwischen den Nahtstücken einer unterbrochenen Schweißnaht.
GapOrPitchLiest oder setzt, ob die unterbrochene Schweißnaht über den Abstand oder über die Teilung bemessen wird.
IntermittentWeldLiest oder setzt, ob die Schweißnaht unterbrochen ist, also aus einzelnen Nahtstücken besteht.
IntermittentWeldLengthLiest oder setzt die Länge der einzelnen Nahtstücke einer unterbrochenen Schweißnaht.
PitchLiest oder setzt die Teilung einer unterbrochenen Schweißnaht, von Mitte zu Mitte der Nahtstücke.
SideLiest oder setzt, wie die Schweißnaht auf die gewählten Flächen oder Kanten kommt: nur auf die Auswahl, beidseitig oder rundum.
StaggeredLiest oder setzt, ob die Nahtstücke einer beidseitigen unterbrochenen Schweißnaht versetzt liegen.
TangentPropagationLiest oder setzt, ob die Schweißnaht auch auf alle tangential anschließenden Kanten kommt.
WeldSymbolLiest oder setzt das Schweißsymbol der kosmetischen Schweißnaht.

Methoden 12, davon 10 beschrieben, 2 veraltet

NameBeschreibung
AccessSelectionsSetzt das Modell vor die kosmetische Schweißnaht zurück, damit du ihre Flächen, Kanten und Pfade lesen und sie ändern kannst.
GetEntitiesveraltet ersetzt durch CosmeticWeldBeadFeatureData.GetEntitiesWeldFrom und CosmeticWeldBeadFeatureData.GetEntitiesWeldTo
GetEntitiesWeldFromLiefert die Flächen oder Kanten, von denen aus die Schweißnaht geht, und ihre Art, bei einer Naht zwischen Geometrie.
GetEntitiesWeldPathLiefert die Kanten und Skizzen einer Schweißnaht, die entlang eines Pfads angelegt wurde.
GetEntitiesWeldToLiefert die Flächen oder Kanten, zu denen hin die Schweißnaht geht, und ihre Art, bei einer Naht zwischen Geometrie.
GetReferenceEdgesLiefert die Referenzkanten, die die kosmetische Schweißnaht erzeugt hat.
GetWeldBeadFolderLiefert den Ordner der kosmetischen Schweißnaht mit Material, Kosten und Summen.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die kosmetische Schweißnaht nicht geändert hast.
SetEntitiesveraltet ersetzt durch CosmeticWeldBeadFeatureData.SetEntitiesWeldFrom und CosmeticWeldBeadFeatureData.SetEntitiesWeldTo
SetEntitiesWeldFromLegt die Flächen oder Kanten fest, von denen aus die Schweißnaht geht, bei einer Naht zwischen Geometrie.
SetEntitiesWeldPathLegt die Kanten und Skizzen fest, entlang derer die Schweißnaht läuft, bei einer Naht entlang eines Pfads.
SetEntitiesWeldToLegt die Flächen oder Kanten fest, zu denen hin die Schweißnaht geht, bei einer Naht zwischen Geometrie.

Siehe auch

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

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