SolidWorksMakroprogrammierung

Objekt · SldWorks

WeldmentBeadFeatureData-Objekt

Die Definition einer Kehlnaht in einer Schweißkonstruktion: Art, Größe, Länge und Abstand der Nahtstücke, Flächen und Kanten, je Pfeilseite und Gegenseite.

Deklaration Dim x As SldWorks.WeldmentBeadFeatureData · in der englischen .NET-Hilfe: IWeldmentBeadFeatureData

Beschreibung

WeldmentBeadFeatureData gibt Zugriff auf eine Kehlnaht (fillet bead) einer Schweißkonstruktion. Eine Kehlnaht kann auf zwei Seiten liegen: der Pfeilseite und der Gegenseite. Fast alle Befehle nehmen deshalb die Seite als Wert aus swWeldBeadSide_e entgegen. Eine versetzte Naht braucht beide Seiten. Die Befehle gibt es seit SOLIDWORKS 2006.

Zugriff

Neu anlegen kannst du eine Kehlnaht mit FeatureManager.InsertFilletBeadFeature3.

Beispiel

' Gibt die Werte der Pfeilseite der ausgewählten Kehlnaht aus und halbiert die Nahtgröße.
' Vorbedingung: Ein Schweißteil mit einer Kehlnaht ist offen, etwa weldment_box3.sldprt
'               aus den Beispielen. Die Kehlnaht ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, die Naht ist halb so groß.
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.WeldmentBeadFeatureData
    Dim nFlaechen1 As Long, nFlaechen2 As Long

    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 <> "WeldBeadFeat" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub

    Debug.Print swFeat.Name & ", Pfeilseite:"
    Select Case swDaten.BeadType(swWeldBeadArrowSide)
        Case swWeldBeadTypeFull:         Debug.Print "  durchgehend"
        Case swWeldBeadTypeIntermittent: Debug.Print "  unterbrochen"
        Case swWeldBeadTypeStaggered:    Debug.Print "  versetzt"
    End Select
    Debug.Print "  Nahtgröße: " & swDaten.BeadSize(swWeldBeadArrowSide) * 1000 & " mm"
    If swDaten.BeadType(swWeldBeadArrowSide) <> swWeldBeadTypeFull Then
        Debug.Print "  Nahtstücke " & swDaten.BeadLength(swWeldBeadArrowSide) * 1000 & " mm, Abstand " & _
                    swDaten.BeadPitch(swWeldBeadArrowSide) * 1000 & " mm"
    End If
    swDaten.GetFacesCount swWeldBeadArrowSide, nFlaechen1, nFlaechen2
    Debug.Print "  Flächen: " & nFlaechen1 & " und " & nFlaechen2 & ", Kanten: " & _
                swDaten.GetVirtualEdgesCount(True, swWeldBeadArrowSide)
    Debug.Print "  beide Seiten: " & swDaten.UseOtherSide

    swDaten.BeadSize(swWeldBeadArrowSide) = swDaten.BeadSize(swWeldBeadArrowSide) * 0.5
    If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Ändern: Nach WeldmentBeadFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du WeldmentBeadFeatureData.ReleaseSelectionAccess auf. So machen es die Hilfebeispiele „Modify Fillet Weld Bead“ (Werte der Pfeilseite halbieren) und „Change Weld Bead Faces“ (Naht auf andere Flächen legen).

Flächen und Kanten: Die Naht liegt an den Kanten, an denen sich die beiden Flächengruppen schneiden. Nach WeldmentBeadFeatureData.SetFaces liegt sie zunächst an allen diesen Schnittkanten. Mit WeldmentBeadFeatureData.GetVirtualEdges holst du die neuen Schnittkanten und legst mit WeldmentBeadFeatureData.SetVirtualEdges fest, an welchen die Naht liegen soll.

Einheiten: Für Größe, Länge und Abstand nennt die Hilfe keine Einheit. Es sind Meter (Nahtgröße 0,005 statt 0,003 ergab 734 mm³ mehr, passend zu einer Kehlnaht von etwa 92 mm Länge).

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

Eigenschaften und Methoden

Eigenschaften 6, davon 6 beschrieben

NameBeschreibung
BeadLengthLiest oder setzt die Länge der einzelnen Nahtstücke einer unterbrochenen oder versetzten Kehlnaht auf einer Seite.
BeadPitchLiest oder setzt den Abstand zwischen den Anfängen der Nahtstücke einer unterbrochenen oder versetzten Kehlnaht auf einer Seite.
BeadSizeLiest oder setzt die Nahtgröße einer Kehlnaht auf einer Seite, also die Schenkellänge.
BeadTypeLiest oder setzt die Art einer Kehlnaht auf einer Seite: durchgehend, unterbrochen oder versetzt.
TangentPropagationLiest oder setzt, ob die Kehlnaht tangential anschließenden Kanten folgt.
UseOtherSideLiest oder setzt, ob die Kehlnaht auf beiden Seiten der sich schneidenden Flächen liegt.

Methoden 8, davon 8 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Kehlnaht zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetFacesLiefert die beiden Flächengruppen einer Seite, an deren Schnittkanten die Kehlnaht liegt.
GetFacesCountLiefert die Zahl der Flächen in den beiden Flächengruppen einer Seite der Kehlnaht.
GetVirtualEdgesLiefert die Schnittkanten einer Seite, an denen die Kehlnaht liegt oder liegen kann.
GetVirtualEdgesCountLiefert die Zahl der Schnittkanten einer Seite der Kehlnaht.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Kehlnaht nicht geändert hast.
SetFacesSetzt die beiden Flächengruppen einer Seite, an deren Schnittkanten die Kehlnaht liegen soll.
SetVirtualEdgesLegt fest, an welchen Schnittkanten einer Seite die Kehlnaht liegt.

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

Siehe auch

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

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