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.
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
Feature.GetDefinition: bei einer Kehlnaht mit dem TypnamenWeldBeadFeat
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 SubBemerkungen
Ä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
| Name | Beschreibung |
|---|---|
| BeadLength | Liest oder setzt die Länge der einzelnen Nahtstücke einer unterbrochenen oder versetzten Kehlnaht auf einer Seite. |
| BeadPitch | Liest oder setzt den Abstand zwischen den Anfängen der Nahtstücke einer unterbrochenen oder versetzten Kehlnaht auf einer Seite. |
| BeadSize | Liest oder setzt die Nahtgröße einer Kehlnaht auf einer Seite, also die Schenkellänge. |
| BeadType | Liest oder setzt die Art einer Kehlnaht auf einer Seite: durchgehend, unterbrochen oder versetzt. |
| TangentPropagation | Liest oder setzt, ob die Kehlnaht tangential anschließenden Kanten folgt. |
| UseOtherSide | Liest oder setzt, ob die Kehlnaht auf beiden Seiten der sich schneidenden Flächen liegt. |
Methoden 8, davon 8 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Kehlnaht zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetFaces | Liefert die beiden Flächengruppen einer Seite, an deren Schnittkanten die Kehlnaht liegt. |
| GetFacesCount | Liefert die Zahl der Flächen in den beiden Flächengruppen einer Seite der Kehlnaht. |
| GetVirtualEdges | Liefert die Schnittkanten einer Seite, an denen die Kehlnaht liegt oder liegen kann. |
| GetVirtualEdgesCount | Liefert die Zahl der Schnittkanten einer Seite der Kehlnaht. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Kehlnaht nicht geändert hast. |
| SetFaces | Setzt die beiden Flächengruppen einer Seite, an deren Schnittkanten die Kehlnaht liegen soll. |
| SetVirtualEdges | Legt 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.