Objekt · SldWorks
SplitBodyFeatureData-Objekt
Die Definition eines Features „Teilen“: Schnittwerkzeuge, entstandene Körper, ihre Zieldateien und ob sie aus dem Teil entfernt werden.
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
Feature.GetDefinition: bei einem Feature mit dem TypnamenSplit
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Consume | Liest oder setzt, ob die Körper des Features „Teilen“ aus dem Teil entfernt werden. |
| OverrideDefaultTemplateSettings | Liest oder setzt, ob für die neuen Dateien beim Teilen eine eigene Vorlage gilt. |
| State | Liest oder setzt den Zustand der Körper des Features „Teilen“: angezeigt, ausgeblendet oder entfernt. |
| TemplatePath | Liest oder setzt die Vorlage für die neuen Dateien beim Teilen. |
| TrimTools | Liefert die Schnittwerkzeuge des Features „Teilen“: Flächen, Referenzebenen, Referenzflächen oder Skizzen. |
Methoden 7, davon 6 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Feature „Teilen“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetSplitBodies | Liefert die Körper des Features „Teilen“ mit Zieldatei und der Angabe, ob sie entfernt werden. |
| GetSplitBodiesCount | Liefert die Zahl der Körper des Features „Teilen“. |
| GetTrimToolsCount | Liefert die Zahl der Schnittwerkzeuge des Features „Teilen“. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Teilen“ nicht geändert hast. |
| SetSplitBodies | veraltet 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.