Objekt · SldWorks
CombineBodiesFeatureData-Objekt
Die Feature-Daten eines Kombinieren-Features in einem Mehrkörperteil: die Körper, die Art der Verknüpfung und der Hauptkörper.
Beschreibung
CombineBodiesFeatureData gibt Zugriff auf ein Kombinieren-Feature. Es verknüpft mehrere Volumenkörper eines Mehrkörperteils: Es vereinigt sie, zieht sie von einem Hauptkörper ab oder behält ihren gemeinsamen Bereich. Du liest die Daten mit Feature.GetDefinition und übernimmst Änderungen mit Feature.ModifyDefinition.
Zugriff
Feature.GetDefinition: aus einem Kombinieren-Feature (TypnameCombineBodies)
Neu anlegen kannst du ein Kombinieren-Feature mit FeatureManager.InsertCombineFeature.
Beispiel
' Gibt Art und Körper des ausgewählten Kombinieren-Features aus, beim Abziehen auch den Hauptkörper.
' Vorbedingung: Ein Mehrkörperteil ist offen, ein Kombinieren-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.CombineBodiesFeatureData
Dim swBody As SldWorks.Body2
Dim vKoerper 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 <> "CombineBodies" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swFeat.Name & ", Art " & swDaten.OperationType & ", " & swDaten.GetBodiesToCombineCount & " Körper"
vKoerper = swDaten.BodiesToCombine
If IsArray(vKoerper) Then
For i = 0 To UBound(vKoerper)
Set swBody = vKoerper(i)
Debug.Print " " & swBody.Name
Next i
End If
If swDaten.OperationType = swCombineBodiesOperationSubtract Then
Set swBody = swDaten.MainBody
If Not swBody Is Nothing Then Debug.Print " Hauptkörper: " & swBody.Name
End If
swDaten.ReleaseSelectionAccess
End SubBemerkungen
Anlegen: Das Hilfebeispiel „Combine Bodies“ wählt zwei Volumenkörper mit ModelDocExtension.SelectByID2, dem Typ SOLIDBODY und der Markierung 2 aus und ruft dann FeatureManager.InsertCombineFeature mit SWBODYADD aus swBodyOperationType_e auf.
Ändern: Du rufst erst CombineBodiesFeatureData.AccessSelections auf und übernimmst Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit CombineBodiesFeatureData.ReleaseSelectionAccess auf.
Zwei Aufzählungen: Zum Anlegen nimmt die Hilfe swBodyOperationType_e, beim Lesen liefert OperationType Werte aus swCombineBodiesOperationType_e.
FeatureManager.InsertCombineFeature liefert Nothing, wenn die Körper nur im Array stehen. Wähle sie zusätzlich wie im Hilfebeispiel mit ModelDocExtension.SelectByID2, Typ SOLIDBODY und Markierung 2 aus.
Eigenschaften und Methoden
Eigenschaften 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| BodiesToCombine | Liest oder setzt die Körper, die das Kombinieren-Feature verknüpft. |
| MainBody | Liest oder setzt den Hauptkörper, der beim Abziehen erhalten bleibt. |
| OperationType | Liest oder setzt, wie das Kombinieren-Feature die Körper verknüpft: hinzufügen, abziehen oder gemeinsamen Bereich behalten. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Kombinieren-Feature zurück, damit du die Körper lesen und ändern kannst. |
| GetBodiesToCombineCount | Liefert die Zahl der Körper, die das Kombinieren-Feature verknüpft. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Kombinieren-Feature nicht geändert hast. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetBodiesToCombine). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ICombineBodiesFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.