SolidWorksMakroprogrammierung

Objekt · SldWorks

LockMateFeatureData-Objekt

Die Daten einer Verriegelung in einer Baugruppe: die beiden Komponenten, deren Lage zueinander festgehalten wird.

Deklaration Dim x As SldWorks.LockMateFeatureData · in der englischen .NET-Hilfe: ILockMateFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
EntitiesToMateLiest 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.