Objekt · SldWorks
LockMateFeatureData-Objekt
Die Daten einer Verriegelung in einer Baugruppe: die beiden Komponenten, deren Lage zueinander festgehalten wird.
Beschreibung
Eine Verriegelung hält Lage und Ausrichtung zweier Komponenten zueinander fest. Sie bestimmt die Komponenten vollständig, wie eine starre Unterbaugruppe. LockMateFeatureData hält ihre Daten. Übergeordnet ist MateFeatureData, das die Art der Verknüpfung liefert (swMateLOCK). Den Befehl gibt es seit SOLIDWORKS 2019.
Zugriff
AssemblyDoc.CreateMateDatamitswMateLOCK: Daten für eine neue Verriegelung, die du anAssemblyDoc.CreateMateübergibstFeature.GetDefinition: die Daten einer vorhandenen Verriegelung
Beispiel
' Legt zwischen zwei ausgewählten Komponenten eine Verriegelung an.
' Vorbedingung: Eine Baugruppe ist offen, zwei Komponenten sind ausgewählt.
' Ergebnis: Eine neue Verriegelung 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.LockMateFeatureData
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 Komponenten 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(swMateLOCK)
swDaten.EntitiesToMate = vElemente
Set swFeat = swAssy.CreateMate(swDaten)
swModel.ClearSelection2 True
If swFeat Is Nothing Then
Debug.Print "Keine Verriegelung entstanden."
Else
Debug.Print "Angelegt: " & swFeat.Name
swModel.EditRebuild3
End If
End SubBemerkungen
Anlegen: Folge dem Ablauf bei AssemblyDoc.CreateMate. Die Elemente setzt du mit LockMateFeatureData.EntitiesToMate oder wählst sie vorher mit ModelDocExtension.SelectByID2 und Markierung 1 aus.
Ändern: Hole mit Feature.GetDefinition das MateFeatureData-Objekt und weise es einer Variablen vom Typ LockMateFeatureData zu. Die Elemente änderst du dann nur über EntitiesToMate, nicht durch Auswahl. Danach rufst du Feature.ModifyDefinition auf. Löschen geht mit ModelDocExtension.DeleteSelection2.
Hilfebeispiel: Das VBA-Beispiel „Create Standard Mates“ wählt zwei Komponenten aus, ruft CreateMateData mit dem Wert 16 auf und übergibt die Komponenten als Array. Es ruft die Befehle über eine Variable vom Typ ModelDoc2 auf. Beide gehören zu AssemblyDoc, das Beispiel hier nimmt deshalb eine Variable vom Typ AssemblyDoc und die Konstante swMateLOCK.
Eigenschaften und Methoden
Eigenschaften 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| EntitiesToMate | Liest oder setzt die Elemente, die eine Verriegelung verbindet, etwa zwei Komponenten. |
Siehe auch
Englisches Original: ILockMateFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.