SolidWorksMakroprogrammierung

Objekt · SldWorks

SaveBodyFeatureData-Objekt

Die Daten eines Features „Körper speichern“: welche Körper als eigene Teile gespeichert werden, unter welchen Namen, und die Baugruppe dazu.

Deklaration Dim x As SldWorks.SaveBodyFeatureData · in der englischen .NET-Hilfe: ISaveBodyFeatureData

Beschreibung

SaveBodyFeatureData gibt Zugriff auf ein Feature „Körper speichern“ (Save Bodies). Es speichert Körper eines Mehrkörperteils als eigene Teildokumente und auf Wunsch eine Baugruppe aus diesen Teilen. Die Befehle gibt es seit SOLIDWORKS 2009.

Zugriff

Beispiel

' Gibt für das ausgewählte Feature "Körper speichern" die Baugruppe und je Körper
' die Datei und den Verbrauch im Ausgangsteil aus.
' Vorbedingung: Ein Teil mit einem Feature "Körper speichern" ist offen, das Feature ist
'               im FeatureManager ausgewählt.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G).
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.SaveBodyFeatureData
    Dim vKoerper As Variant, vDateien As Variant, vVerbraucht As Variant
    Dim i 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 swSel Is Nothing Then Exit Sub
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "CreateAssemFeat" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": " & swDaten.GetSaveBodiesCount & " Körper"
    Debug.Print "Baugruppe: " & swDaten.AssemblyPath
    swDaten.GetSaveBodies vKoerper, vDateien, vVerbraucht
    If Not IsEmpty(vDateien) Then
        For i = 0 To UBound(vDateien)
            Debug.Print "  " & vDateien(i) & IIf(vVerbraucht(i), " (verbraucht)", "")
        Next i
    End If
    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Lesen und Ändern: Die Körper gibt es nur nach SaveBodyFeatureData.AccessSelections, so macht es auch das Hilfebeispiel „Get Number of Bodies in Save Bodies Feature“. Zum Schluss rufst du Feature.ModifyDefinition auf, wenn du etwas geändert hast, sonst SaveBodyFeatureData.ReleaseSelectionAccess.

Anlegen: FeatureManager.CreateSaveBodyFeature nimmt die Körper, die Dateinamen, den Namen der Baugruppe und die beiden Schalter für Verbrauchen und Eigenschaften. Das Hilfebeispiel „Create Save Bodies Feature and Create Assembly“ holt die Körper aus dem Ordner der Volumenkörper (BodyFolder.GetBodies).

Typname: In der Tabelle bei Feature.GetTypeName2 heißt das Feature CreateAssemFeat, und so meldet es sich auch.

SaveBodyFeatureData.GetSaveBodies meldet die Körper als verbraucht (True), auch wenn SaveBodyFeatureData.ConsumeBody False ist und die Körper im Teil sichtbar bleiben.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
AssemblyPathLiest oder setzt Pfad und Dateinamen der Baugruppe, die das Feature „Körper speichern“ aus den gespeicherten Körpern anlegt.
ConsumeBodyLiest oder setzt, ob das Feature „Körper speichern“ alle Körper im Ausgangsteil verbraucht.
CopyCustomPropertiesLiest oder setzt, ob das Feature „Körper speichern“ die benutzerdefinierten Eigenschaften in die neuen Teile kopiert.

Methoden 6, davon 6 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Körper speichern“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
AddSaveBodiesFügt dem Feature „Körper speichern“ Körper hinzu und speichert sie als Teildokumente.
GetSaveBodiesLiefert die Körper des Features „Körper speichern“ mit den Dateien und ob sie im Ausgangsteil verbraucht werden.
GetSaveBodiesCountLiefert die Zahl der Körper im Feature „Körper speichern“.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Körper speichern“ nicht geändert hast.
RemoveSaveBodiesEntfernt Körper aus dem Feature „Körper speichern“.

Siehe auch

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

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