SolidWorksMakroprogrammierung

Objekt · SldWorks

TangentMateFeatureData-Objekt

Die Daten einer tangentialen Verknüpfung in einer Baugruppe: die beiden Elemente, ihre Pickpunkte und die Ausrichtung.

Deklaration Dim x As SldWorks.TangentMateFeatureData · in der englischen .NET-Hilfe: ITangentMateFeatureData

Beschreibung

Eine tangentiale Verknüpfung legt die gewählten Elemente tangential aneinander. Mindestens eines davon muss zylindrisch, kegelförmig oder kugelförmig sein. TangentMateFeatureData hält ihre Daten. Übergeordnet ist MateFeatureData, das die Art der Verknüpfung liefert (swMateTANGENT). Die Befehle gibt es seit SOLIDWORKS 2019.

Zugriff

Beispiel

' Legt zwischen zwei ausgewählten Elementen verschiedener Komponenten eine tangentiale
' Verknüpfung an.
' Vorbedingung: Eine Baugruppe ist offen, zwei passende Elemente sind ausgewählt,
'               etwa eine Zylinderfläche und eine ebene Fläche.
' Ergebnis:     Eine neue tangentiale 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.TangentMateFeatureData
    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(swMateTANGENT)
    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. Dann setzt du die übrigen Eigenschaften.

Ändern: Hole mit Feature.GetDefinition das MateFeatureData-Objekt und weise es einer Variablen vom Typ TangentMateFeatureData zu. Die Elemente änderst du dann nur über EntitiesToMate, nicht durch Auswahl. Danach rufst du Feature.ModifyDefinition auf. Löschen geht mit ModelDocExtension.DeleteSelection2.

Pickpunkte: Nach dem Anlegen lassen sich TangentMateFeatureData.PickPoints nicht mehr ändern.

Hilfebeispiel: Das VBA-Beispiel „Create Standard Mates“ ruft CreateMateData und CreateMate über eine Variable vom Typ ModelDoc2 auf. Beide Befehle gehören zu AssemblyDoc, das Beispiel hier nimmt deshalb eine Variable vom Typ AssemblyDoc. Die Ausrichtung 1 (swMateAlignANTI_ALIGNED) stammt aus dem Hilfebeispiel.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
EntitiesToMateLiest oder setzt die beiden Elemente, die eine tangentiale Verknüpfung verbindet, etwa eine Zylinderfläche und eine Ebene.
MateAlignmentLiest oder setzt die Ausrichtung einer tangentialen Verknüpfung: gleich oder entgegengesetzt ausgerichtet.
PickPointsLiest oder setzt die Pickpunkte der beiden Elemente, die die Lage der tangentialen Verknüpfung festlegen.

Siehe auch

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

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