SolidWorksMakroprogrammierung

Objekt · SldWorks

SplitBodyFeatureData-Objekt

Die Definition eines Features „Teilen“: Schnittwerkzeuge, entstandene Körper, ihre Zieldateien und ob sie aus dem Teil entfernt werden.

Deklaration Dim x As SldWorks.SplitBodyFeatureData · in der englischen .NET-Hilfe: ISplitBodyFeatureData

Beschreibung

SplitBodyFeatureData gibt Zugriff auf ein Feature „Teilen“ (Split). Es teilt die Körper eines Teils mit Schnittwerkzeugen wie Ebenen, Flächen oder Skizzen und kann die entstandenen Körper als eigene Teile speichern. Die meisten Befehle gibt es seit SOLIDWORKS 2005, die Vorlagen-Einstellungen seit SOLIDWORKS 2018.

Zugriff

Angelegt wird das Feature mit FeatureManager.PreSplitBody2 und FeatureManager.PostSplitBody2.

Beispiel

' Gibt für das ausgewählte Feature „Teilen“ die Zahl der Schnittwerkzeuge und für jeden
' Körper die Zieldatei und das Entfernen aus.
' Vorbedingung: Ein Teil mit einem Feature „Teilen“ ist offen, das Feature 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.SplitBodyFeatureData
    Dim vKoerper As Variant, vPfade As Variant, vEntfernt 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 Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "Split" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & ": " & swDaten.GetTrimToolsCount & " Schnittwerkzeug(e), " & _
                swDaten.GetSplitBodiesCount & " Körper"
    swDaten.GetSplitBodies vKoerper, vPfade, vEntfernt
    If IsArray(vKoerper) Then
        For i = 0 To UBound(vKoerper)
            Debug.Print "  Körper " & i + 1 & ": " & IIf(vPfade(i) = "", "nicht gespeichert", vPfade(i)) & _
                        IIf(vEntfernt(i), ", entfernt", "")
        Next i
    End If
    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Typnamen: Feature.GetTypeName2 liefert Split für das Feature „Teilen“, ob mit FeatureManager.PostSplitBody2 oder in der Oberfläche angelegt. Ein Körper, der beim Teilen in ein eigenes Teil gespeichert wurde, hat dort den Typnamen SplitBody. Auf dessen Daten kommst du nicht zu.

Ändern: Nach SplitBodyFeatureData.AccessSelections liest du die Körper mit SplitBodyFeatureData.GetSplitBodies, änderst sie mit SplitBodyFeatureData.SetSplitBodies2 und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du SplitBodyFeatureData.ReleaseSelectionAccess auf. Für Einzelheiten verweist die Hilfe auf das Thema „Accessing Selections that Define Features“.

Veraltet: SetSplitBodies ist durch SplitBodyFeatureData.SetSplitBodies2 ersetzt, das zusätzlich die Ursprünge der Körper nimmt. SplitBodyFeatureData.State gilt in der alten Hilfe ebenfalls als veraltet und durch SplitBodyFeatureData.Consume ersetzt, steht aber noch in der aktuellen Befehlsliste.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
ConsumeLiest oder setzt, ob die Körper des Features „Teilen“ aus dem Teil entfernt werden.
OverrideDefaultTemplateSettingsLiest oder setzt, ob für die neuen Dateien beim Teilen eine eigene Vorlage gilt.
StateLiest oder setzt den Zustand der Körper des Features „Teilen“: angezeigt, ausgeblendet oder entfernt.
TemplatePathLiest oder setzt die Vorlage für die neuen Dateien beim Teilen.
TrimToolsLiefert die Schnittwerkzeuge des Features „Teilen“: Flächen, Referenzebenen, Referenzflächen oder Skizzen.

Methoden 7, davon 6 beschrieben, 1 veraltet

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Teilen“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetSplitBodiesLiefert die Körper des Features „Teilen“ mit Zieldatei und der Angabe, ob sie entfernt werden.
GetSplitBodiesCountLiefert die Zahl der Körper des Features „Teilen“.
GetTrimToolsCountLiefert die Zahl der Schnittwerkzeuge des Features „Teilen“.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Teilen“ nicht geändert hast.
SetSplitBodiesveraltet ersetzt durch SplitBodyFeatureData.SetSplitBodies2
SetSplitBodies2Ändert die Körper des Features „Teilen“: Zieldateien, Entfernen und Ursprung je Körper.

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

Siehe auch

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

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