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.
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
AssemblyDoc.CreateMateDatamitswMateLINEARCOUPLER: Daten für eine neue Verknüpfung, die du anAssemblyDoc.CreateMateübergibstFeature.GetDefinition: die Daten einer vorhandenen Verknüpfung Linear/Linear-Kopplung (TypnameMateLinearCoupler)
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| CouplerRatioDenominator | Liest oder setzt den Nenner des Verhältnisses der Verknüpfung Linear/Linear-Kopplung, vermutlich den Weg der zweiten Komponente. |
| CouplerRatioNumerator | Liest oder setzt den Zähler des Verhältnisses der Verknüpfung Linear/Linear-Kopplung: den Weg der ersten Komponente in ihrer Bewegungsrichtung. |
| MateEntity1 | Liest oder setzt das Element der ersten Komponente der Verknüpfung Linear/Linear-Kopplung, eine Fläche oder Kante. |
| MateEntity2 | Liest oder setzt das Element der zweiten Komponente der Verknüpfung Linear/Linear-Kopplung. |
| ReferenceComponent1 | Liest oder setzt die Bezugskomponente, auf die sich die Bewegung der ersten Komponente der Verknüpfung Linear/Linear-Kopplung bezieht. |
| ReferenceComponent2 | Liest oder setzt die Bezugskomponente, auf die sich die Bewegung der zweiten Komponente der Verknüpfung Linear/Linear-Kopplung bezieht. |
| Reverse | Liest 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.