Objekt · SldWorks
ScrewMateFeatureData-Objekt
Die Daten einer Schraubenverknüpfung in einer Baugruppe: die beiden zylindrischen Flächen, die Steigung und die Richtung.
Beschreibung
Eine Schraubenverknüpfung macht zwei Komponenten konzentrisch und koppelt Schieben und Drehen über eine Steigung: Verschiebst du eine Komponente entlang der Achse, dreht sich die andere, und dreht sich eine, verschiebt sich die andere. ScrewMateFeatureData hält ihre Daten. Übergeordnet ist MateFeatureData. Die Befehle gibt es seit SOLIDWORKS 2019.
Zugriff
AssemblyDoc.CreateMateDatamitswMateSCREW: Daten für eine neue Verknüpfung, die du anAssemblyDoc.CreateMateübergibstFeature.GetDefinition: die Daten einer vorhandenen Schraubenverknüpfung (TypnameMateScrew)
Beispiel
' Legt eine Schraubenverknüpfung zwischen den beiden ausgewählten zylindrischen Flächen
' an. Eine Umdrehung verschiebt die andere Komponente um 1,5 mm.
' Vorbedingung: Eine Baugruppe ist offen, zwei zylindrische Flächen verschiedener
' Komponenten sind ausgewählt.
' Ergebnis: Eine neue Schraubenverknü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.ScrewMateFeatureData
Dim swFeat As SldWorks.Feature
Dim vElemente(1) 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 zylindrische Flächen auswählen."
Exit Sub
End If
Set vElemente(0) = swSelMgr.GetSelectedObject6(1, -1)
Set vElemente(1) = swSelMgr.GetSelectedObject6(2, -1)
Set swDaten = swAssy.CreateMateData(swMateSCREW)
swDaten.EntitiesToMate = vElemente
swDaten.RevolutionType = swDistancePerRevolution
swDaten.RevolutionVal = 0.0015 ' Meter je Umdrehung (siehe Bemerkungen)
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. Die Flächen setzt du mit ScrewMateFeatureData.EntitiesToMate oder wählst sie vorher mit ModelDocExtension.SelectByID2 und der Markierung 1 aus. Vorher auswählen geht nur beim Anlegen, nicht beim Ändern.
Ändern: Hole mit Feature.GetDefinition das MateFeatureData-Objekt und weise es einer Variablen vom Typ ScrewMateFeatureData zu. Dann änderst du die Werte und rufst Feature.ModifyDefinition auf. Löschen geht mit ModelDocExtension.DeleteSelection2.
Hilfebeispiel: Das VBA-Beispiel der Hilfe öffnet Gearbox.sldasm aus den Lernbeispielen, wählt die Flächen mit ModelDocExtension.SelectByRay aus und ruft CreateMateData und CreateMate über eine Variable vom Typ ModelDoc2 mit der Zahl 17 auf. Es setzt RevolutionType = 0 (swRevolutionsPerUnitLength), RevolutionVal = 1 und Reverse = True. Beide Befehle gehören zu AssemblyDoc, das Beispiel hier nimmt deshalb eine Variable vom Typ AssemblyDoc und die Konstante swMateSCREW.
Einheiten: Für den Weg je Umdrehung nennt die Hilfe keine Einheit; es sind Meter: Bei 1,00 mm im PropertyManager meldete RevolutionVal 0,001. Bei Umdrehungen je Längeneinheit ist die Längeneinheit des Dokuments gemeint: 1 Umdrehung/mm in einem Millimeter-Dokument meldete 1. RevolutionVal übernahm SOLIDWORKS 2024 weder beim Anlegen noch mit ModifyDefinition (geprüft mit 0,0015, 0,005, 0,015, 3, 9 und 1,5; ModifyDefinition lieferte True): Die Verknüpfung behielt immer den Vorgabewert, 1 mm je Umdrehung (0,001) oder 1 Umdrehung je mm (1). RevolutionType und Reverse kamen dagegen an.
Eigenschaften und Methoden
Eigenschaften 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| EntitiesToMate | Liest oder setzt die beiden zylindrischen Flächen der Schraubenverknüpfung. |
| MateAlignment | Liest oder setzt die Ausrichtung der Schraubenverknüpfung. |
| Reverse | Liest oder setzt, ob die Schraubenverknüpfung die Bewegungsrichtung der Komponenten zueinander umkehrt. |
| RevolutionType | Liest oder setzt, wie die Steigung der Schraubenverknüpfung angegeben wird: als Weg je Umdrehung oder als Umdrehungen je Längeneinheit. |
| RevolutionVal | Liest oder setzt die Steigung der Schraubenverknüpfung: den Weg je Umdrehung oder die Umdrehungen je Längeneinheit. |
Siehe auch
Englisches Original: IScrewMateFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.