SolidWorksMakroprogrammierung

Objekt · SldWorks

MateFeatureData-Objekt

Gemeinsame Grundlage der Daten aller Verknüpfungsarten: liefert die Art der Verknüpfung und den Status nach dem Anlegen oder Ändern.

Deklaration Dim x As SldWorks.MateFeatureData · in der englischen .NET-Hilfe: IMateFeatureData

Beschreibung

MateFeatureData ist die Grundlage der Datenobjekte für die einzelnen Verknüpfungsarten, etwa CoincidentMateFeatureData oder LockMateFeatureData. AssemblyDoc.CreateMateData und Feature.GetDefinition liefern ein solches Objekt. Es ist zugleich das Datenobjekt der passenden Art: Weist du es einer Variablen dieses Typs zu, kommst du an die Eigenschaften der Art. MateFeatureData selbst hat nur zwei Eigenschaften, die für alle Arten gelten. TypeName gibt es seit SOLIDWORKS 2018, ErrorStatus seit SOLIDWORKS 2019.

Die Datenobjekte der Arten, dazu der Wert für CreateMateData:

Zugriff

Beispiel

' Legt zwischen zwei ausgewählten ebenen Flächen eine Abstandsverknüpfung von 10 mm an.
' Vorbedingung: Eine Baugruppe ist offen, zwei ebene Flächen verschiedener Komponenten sind ausgewählt.
' Ergebnis:     Eine neue Abstandsverknüpfung im Ordner "Verknüpfungen", Art und Status
'               stehen im Direktfenster.
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 swMateDaten As SldWorks.MateFeatureData
    Dim swDaten As SldWorks.DistanceMateFeatureData
    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 Flächen auswählen."
        Exit Sub
    End If
    Set aElemente(0) = swSelMgr.GetSelectedObject6(1, -1)
    Set aElemente(1) = swSelMgr.GetSelectedObject6(2, -1)
    vElemente = aElemente

    Set swMateDaten = swAssy.CreateMateData(swMateDISTANCE)
    Debug.Print "Art: " & swMateDaten.TypeName                  ' 5 = swMateDISTANCE
    Set swDaten = swMateDaten                                   ' dieselben Daten, anderer Typ
    swDaten.EntitiesToMate = vElemente
    swDaten.Distance = 0.01                                     ' 10 mm
    swDaten.MateAlignment = swMateAlignALIGNED

    Set swFeat = swAssy.CreateMate(swDaten)
    swModel.ClearSelection2 True
    If Not swFeat Is Nothing Then
        Debug.Print "Angelegt: " & swFeat.Name
        swModel.EditRebuild3
    End If
    If swMateDaten.ErrorStatus <> swAddMateError_NoError Then
        Debug.Print "Status " & swMateDaten.ErrorStatus & " (swAddMateError_e)"
    End If
End Sub

Bemerkungen

Ein Objekt, zwei Variablen: CreateMateData und GetDefinition liefern in VBA ein Object. Die Hilfebeispiele weisen es einer Variablen vom Typ MateFeatureData zu, prüfen mit TypeName die Art und weisen es dann mit Set einer Variablen der passenden Art zu, etwa DistanceMateFeatureData. Beide Variablen zeigen auf dieselben Daten. TypeName und ErrorStatus führt die Hilfe nur bei MateFeatureData auf, nicht bei den Datenobjekten der Arten. Du liest sie deshalb über die Variable vom Typ MateFeatureData.

Anlegen: Bei AssemblyDoc.CreateMate holst du die Daten mit AssemblyDoc.CreateMateData, setzt die allgemeinen Eigenschaften und weist die Daten der Variablen der passenden Art zu. Dort setzt du die Eigenschaften der Art oder wählst die Elemente vorher aus, dann rufst du CreateMate auf. Welche allgemeinen Eigenschaften gemeint sind, sagt die Hilfe nicht. MateFeatureData hat außer TypeName und ErrorStatus keine.

Vorauswahl: Nach CreateMate darfst du die Elemente bei Kurvenfolger, deckungsgleich, konzentrisch, Zahnrad, Scharnier, Verriegelung, parallel, senkrecht, Zahnstange und Ritzel, Schraube, Nut, tangential und Kardangelenk vorher auswählen. Die Hilfeseiten zu Winkel, Abstand, Profilmittelpunkt, symmetrisch und Breite beschreiben trotzdem eine Vorauswahl mit ModelDocExtension.SelectByID2. Was davon gilt, ist offen.

Ändern: Hole mit Feature.GetDefinition das MateFeatureData-Objekt, weise es einer Variablen der passenden Art zu, ändere die Werte und rufe Feature.ModifyDefinition auf. Den Status liefert danach vermutlich wieder MateFeatureData.ErrorStatus.

Andere Wege: Versetzte konzentrische Verknüpfungen legst du mit AssemblyDoc.AddConcentricMateWithTolerance an, Abstandsverknüpfungen zwischen Zylinderflächen mit AssemblyDoc.AddDistanceMate. Für einige Arten aus swMateType_e, etwa Pfad oder magnetische Verknüpfung, gibt es kein Datenobjekt. Art, Ausrichtung und Elemente einer vorhandenen Verknüpfung liefert auch Mate2.

Eigenschaften und Methoden

Eigenschaften 2, davon 2 beschrieben

NameBeschreibung
ErrorStatusLiefert den Status nach dem Anlegen oder Ändern der Verknüpfung: Erfolg oder den Grund für den Fehler.
TypeNameLiest oder setzt die Art der Verknüpfung, etwa deckungsgleich, Abstand oder Verriegelung.

Siehe auch

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

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