SolidWorksMakroprogrammierung

Objekt · SldWorks

LinearCouplerMateFeatureData-Objekt

Die Daten einer Verknüpfung Linear/Linear-Kopplung in einer Baugruppe: die beiden Elemente, das Verhältnis der Wege, die Bezugskomponenten und die Richtung.

Deklaration Dim x As SldWorks.LinearCouplerMateFeatureData · in der englischen .NET-Hilfe: ILinearCouplerMateFeatureData

Beschreibung

Eine Verknüpfung Linear/Linear-Kopplung (lineare Kopplung) koppelt die Verschiebung einer Komponente an die Verschiebung einer anderen Komponente. LinearCouplerMateFeatureData hält ihre Daten. Übergeordnet ist MateFeatureData. Die Befehle gibt es seit SOLIDWORKS 2018.

Zugriff

Beispiel

' Legt eine Verknüpfung Linear/Linear-Kopplung zwischen den beiden ausgewählten
' Elementen an. Verschiebt sich die erste Komponente um 1 mm, verschiebt sich die
' zweite um 2 mm.
' Vorbedingung: Eine Baugruppe ist offen, zwei Flächen oder Kanten verschiedener
'               Komponenten sind ausgewählt.
' Ergebnis:     Eine neue 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 swMateDaten As SldWorks.MateFeatureData
    Dim swDaten As SldWorks.LinearCouplerMateFeatureData
    Dim swFeat As SldWorks.Feature
    Dim swElement1 As Object
    Dim swElement2 As Object

    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 zwei Flächen oder Kanten auswählen."
        Exit Sub
    End If
    Set swElement1 = swSelMgr.GetSelectedObject6(1, -1)
    Set swElement2 = swSelMgr.GetSelectedObject6(2, -1)

    Set swMateDaten = swAssy.CreateMateData(swMateLINEARCOUPLER)
    If swMateDaten.TypeName <> swMateLINEARCOUPLER Then Exit Sub
    Set swDaten = swMateDaten
    swDaten.MateEntity1 = swElement1
    swDaten.MateEntity2 = swElement2
    swDaten.CouplerRatioNumerator = 0.001                ' vermutlich Meter
    swDaten.CouplerRatioDenominator = 0.002              ' vermutlich Meter
    swDaten.Reverse = False

    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, setze LinearCouplerMateFeatureData.MateEntity1 und LinearCouplerMateFeatureData.MateEntity2 und dann die übrigen Eigenschaften nach Bedarf. Vorher auswählen geht bei dieser Art nicht, wie bei CreateMate steht.

Ändern: Hole mit Feature.GetDefinition das MateFeatureData-Objekt und weise es einer Variablen vom Typ LinearCouplerMateFeatureData zu. Dann änderst du die Werte und rufst Feature.ModifyDefinition auf. Löschen geht mit ModelDocExtension.DeleteSelection2.

Hilfebeispiel: Das VBA-Beispiel „Create and Edit Linear-Linear Coupler Mate“ öffnet AdvancedMateDemo4.sldasm aus den Lernbeispielen und ruft CreateMateData mit der Zahl 18 auf. Es prüft mit MateFeatureData.TypeName die Art, setzt CouplerRatioNumerator = 0.00099, CouplerRatioDenominator = 0.00199 und Reverse = False, wählt zwei Flächen mit ModelDocExtension.SelectByRay aus und weist sie MateEntity1 und MateEntity2 ohne Set zu. Nach CreateMate holt es die Verknüpfung mit ModelDocExtension.GetLastFeatureAdded, kehrt Reverse um und übernimmt das mit ModifyDefinition. ReferenceComponent1 und ReferenceComponent2 setzt es nicht.

Bezug: Ohne Bezugskomponente bewegt sich eine Komponente bezogen auf den Ursprung der Baugruppe.

Einheiten: Für Zähler und Nenner nennt die Hilfe keine Einheit. Die Hilfe nennt den Zähler den Weg der ersten Komponente, vermutlich in Meter. Zum Nenner hat die Hilfe keinen Text, vermutlich ist er der Weg der zweiten Komponente.

Hältst du die Daten in einer Variablen As Object, löst MateFeatureData.TypeName den Laufzeitfehler 91 aus; deklariere die Variable deshalb wie im Hilfebeispiel As MateFeatureData.

Eigenschaften und Methoden

Eigenschaften 7, davon 7 beschrieben

NameBeschreibung
CouplerRatioDenominatorLiest oder setzt den Nenner des Verhältnisses der Verknüpfung Linear/Linear-Kopplung, vermutlich den Weg der zweiten Komponente.
CouplerRatioNumeratorLiest oder setzt den Zähler des Verhältnisses der Verknüpfung Linear/Linear-Kopplung: den Weg der ersten Komponente in ihrer Bewegungsrichtung.
MateEntity1Liest oder setzt das Element der ersten Komponente der Verknüpfung Linear/Linear-Kopplung, eine Fläche oder Kante.
MateEntity2Liest oder setzt das Element der zweiten Komponente der Verknüpfung Linear/Linear-Kopplung.
ReferenceComponent1Liest oder setzt die Bezugskomponente, auf die sich die Bewegung der ersten Komponente der Verknüpfung Linear/Linear-Kopplung bezieht.
ReferenceComponent2Liest oder setzt die Bezugskomponente, auf die sich die Bewegung der zweiten Komponente der Verknüpfung Linear/Linear-Kopplung bezieht.
ReverseLiest oder setzt, ob die zweite Komponente der Verknüpfung Linear/Linear-Kopplung sich entgegen der ersten bewegt.

Siehe auch

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

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