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.
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:
AngleMateFeatureData: Winkel (swMateANGLE)CamFollowerMateFeatureData: Kurvenfolger (swMateCAMFOLLOWER)CoincidentMateFeatureData: deckungsgleich (swMateCOINCIDENT)ConcentricMateFeatureData: konzentrisch (swMateCONCENTRIC)DistanceMateFeatureData: Abstand (swMateDISTANCE)GearMateFeatureData: Zahnrad (swMateGEAR)HingeMateFeatureData: Scharnier (swMateHINGE)LinearCouplerMateFeatureData: lineare Kopplung (swMateLINEARCOUPLER)LockMateFeatureData: Verriegelung (swMateLOCK)ParallelMateFeatureData: parallel (swMatePARALLEL)PerpendicularMateFeatureData: senkrecht (swMatePERPENDICULAR)ProfileCenterMateFeatureData: Profilmittelpunkt (swMatePROFILECENTER)RackPinionMateFeatureData: Zahnstange und Ritzel (swMateRACKPINION)ScrewMateFeatureData: Schraube (swMateSCREW)SlotMateFeatureData: Nut (swMateSLOT)SymmetricMateFeatureData: symmetrisch (swMateSYMMETRIC)TangentMateFeatureData: tangential (swMateTANGENT)UniversalJointMateFeatureData: Kardangelenk (swMateUNIVERSALJOINT)WidthMateFeatureData: Breite (swMateWIDTH)
Zugriff
AssemblyDoc.CreateMateData: Daten für eine neue Verknüpfung der angegebenen Art, die du anAssemblyDoc.CreateMateübergibstFeature.GetDefinition: die Daten einer vorhandenen Verknüpfung
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| ErrorStatus | Liefert den Status nach dem Anlegen oder Ändern der Verknüpfung: Erfolg oder den Grund für den Fehler. |
| TypeName | Liest 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.