SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.CombineBodiesFeatureData · in der englischen .NET-Hilfe: ICombineBodiesFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
BodiesToCombineLiest oder setzt die Körper, die das Kombinieren-Feature verknüpft.
MainBodyLiest oder setzt den Hauptkörper, der beim Abziehen erhalten bleibt.
OperationTypeLiest oder setzt, wie das Kombinieren-Feature die Körper verknüpft: hinzufügen, abziehen oder gemeinsamen Bereich behalten.

Methoden 3, davon 3 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Kombinieren-Feature zurück, damit du die Körper lesen und ändern kannst.
GetBodiesToCombineCountLiefert die Zahl der Körper, die das Kombinieren-Feature verknüpft.
ReleaseSelectionAccessHebt 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.