SolidWorksMakroprogrammierung

Objekt · SldWorks

SymmetricMateFeatureData-Objekt

Die Daten einer symmetrischen Verknüpfung in einer Baugruppe: die beiden Elemente, die Symmetrieebene und die Ausrichtung.

Deklaration Dim x As SldWorks.SymmetricMateFeatureData · in der englischen .NET-Hilfe: ISymmetricMateFeatureData

Beschreibung

Eine symmetrische Verknüpfung zwingt zwei gleichartige Elemente in eine symmetrische Lage zu einer Ebene oder ebenen Fläche. Sie gehört zu den erweiterten Verknüpfungen. SymmetricMateFeatureData hält ihre Daten. Übergeordnet ist MateFeatureData, das die Art der Verknüpfung liefert (swMateSYMMETRIC). Die Befehle gibt es seit SOLIDWORKS 2018.

Zugriff

Beispiel

' Legt zwischen zwei ausgewählten Flächen verschiedener Komponenten eine symmetrische
' Verknüpfung zur Ebene "Front Plane" der Baugruppe an.
' Vorbedingung: Eine Baugruppe ist offen, zwei gleichartige Flächen sind ausgewählt.
'               Die Ebene heißt in der deutschen Oberfläche "Ebene vorne", sonst Namen anpassen.
' Ergebnis:     Eine neue symmetrische Verknüpfung im Ordner "Verknüpfungen".
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swAssy As SldWorks.AssemblyDoc
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swDaten As SldWorks.SymmetricMateFeatureData
    Dim swFeat As SldWorks.Feature
    Dim aElemente(1) As Object
    Dim vElemente As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY Then Exit Sub
    Set swAssy = swModel
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectCount2(-1) <> 2 Then
        Debug.Print "Bitte genau zwei Elemente auswählen."
        Exit Sub
    End If
    Set aElemente(0) = swSelMgr.GetSelectedObject6(1, -1)
    Set aElemente(1) = swSelMgr.GetSelectedObject6(2, -1)
    vElemente = aElemente

    Set swDaten = swAssy.CreateMateData(swMateSYMMETRIC)
    swDaten.SymmetryPlane = swAssy.FeatureByName("Ebene vorne")   ' englisch: "Front Plane"
    swDaten.EntitiesToMate = vElemente
    swDaten.MateAlignment = swMateAlignANTI_ALIGNED

    Set swFeat = swAssy.CreateMate(swDaten)
    swModel.ClearSelection2 True
    If swFeat Is Nothing Then
        Debug.Print "Keine Verknüpfung entstanden."
    Else
        Debug.Print "Angelegt: " & swFeat.Name
        swModel.EditRebuild3
    End If
End Sub

Bemerkungen

Anlegen: Folge dem Ablauf bei AssemblyDoc.CreateMate. Die Elemente setzt du mit EntitiesToMate oder wählst sie vorher mit ModelDocExtension.SelectByID2 und Markierung 1 aus. Die Symmetrieebene setzt du mit SymmetryPlane oder wählst sie vorher mit Markierung 4 aus. Dann setzt du die übrigen Eigenschaften. Die Liste bei CreateMate führt symmetrische Verknüpfungen allerdings nicht unter den Arten mit Vorauswahl; was gilt, ist offen.

Ändern: Hole mit Feature.GetDefinition das MateFeatureData-Objekt und weise es einer Variablen vom Typ SymmetricMateFeatureData zu. Nach den Änderungen rufst du Feature.ModifyDefinition auf. So tauscht das Hilfebeispiel „Create and Edit Symmetric Mate“ Ebene und Flächen aus. Löschen geht mit ModelDocExtension.DeleteSelection2.

Ebene holen: Das Hilfebeispiel holt die Ebene mit AssemblyDoc.FeatureByName über ihren Namen und weist das Feature direkt SymmetryPlane zu. Bei einer deutschen Vorlage heißt die Ebene meist anders.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
EntitiesToMateLiest oder setzt die beiden gleichartigen Elemente, die die Verknüpfung symmetrisch zur Ebene hält.
MateAlignmentLiest oder setzt die Ausrichtung der symmetrischen Verknüpfung: gleich oder entgegengesetzt ausgerichtet.
SymmetryPlaneLiest oder setzt die Ebene, zu der die beiden Elemente symmetrisch liegen.

Siehe auch

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

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