Objekt · SldWorks
GearMateFeatureData-Objekt
Die Daten einer Zahnradverknüpfung in einer Baugruppe: die beiden Elemente, das Übersetzungsverhältnis und die Drehrichtung.
Beschreibung
Eine Zahnradverknüpfung (gear mate) lässt zwei Komponenten um ausgewählte Achsen relativ zueinander drehen. GearMateFeatureData hält ihre Daten. Übergeordnet ist MateFeatureData. Die Befehle gibt es seit SOLIDWORKS 2019.
Zugriff
AssemblyDoc.CreateMateDatamitswMateGEAR(swMateType_e): Daten für eine neue Verknüpfung, die du anAssemblyDoc.CreateMateübergibstFeature.GetDefinition: die Daten einer vorhandenen Zahnradverknüpfung (TypnameMateGearDim)
Beispiel
' Legt eine Zahnradverknüpfung zwischen den beiden ausgewählten zylindrischen Flächen
' an, mit dem Übersetzungsverhältnis 20 : 40.
' Vorbedingung: Eine Baugruppe ist offen, zwei zylindrische Flächen verschiedener
' Komponenten sind ausgewählt.
' Ergebnis: Eine neue Zahnradverknü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.GearMateFeatureData
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(swMateGEAR)
swDaten.EntitiesToMate = vElemente
swDaten.GearRatioNumerator = 0.02 ' Meter
swDaten.GearRatioDenominator = 0.04
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 Elemente setzt du mit GearMateFeatureData.EntitiesToMate oder wählst sie vorher mit ModelDocExtension.SelectByID2 und der Markierung 1 aus. Vorher auswählen geht nur beim Anlegen, nicht beim Ändern. Als Elemente nennt die Hilfe zylindrische oder kegelige Flächen, Achsen und gerade Kanten.
Ändern: Hole mit Feature.GetDefinition das MateFeatureData-Objekt und weise es einer Variablen vom Typ GearMateFeatureData zu. Dann änderst du die Werte und rufst Feature.ModifyDefinition auf. Löschen geht mit ModelDocExtension.DeleteSelection2.
Hilfebeispiel: Das VBA-Beispiel der Hilfe nimmt spurgear.sldasm aus den Lernbeispielen (MechanicalMates), aus der du vorher GearMate1 löschst. Es wählt zwei Flächen mit ModelDocExtension.SelectByRay aus und ruft CreateMateData und CreateMate über eine Variable vom Typ ModelDoc2 mit der Zahl 10 (swMateGEAR) auf. Zähler und Nenner setzt es beide auf 0.012954, Reverse auf False. Beide Befehle gehören zu AssemblyDoc, das Beispiel hier nimmt deshalb eine Variable vom Typ AssemblyDoc und die Konstante swMateGEAR.
Einheiten: Für Zähler und Nenner nennt die Hilfe keine Einheit. Bei Mate2.DisplayDimension2 steht: Eine Zahnradverknüpfung hat zwei Maße, deren Werte das Übersetzungsverhältnis bilden. Das Hilfebeispiel „Change Dimensions of Gear Mate“ gibt diese Maße in Millimetern aus. Zähler und Nenner sind Längen in Metern, etwa die Durchmesser der Zahnräder. Für ein ungültiges Verhältnis gibt es den Fehlerwert swAddMateError_IncorrectGearRatios (swAddMateError_e). Ob und wo AssemblyDoc.CreateMate ihn meldet, sagt die Hilfe nicht.
Zähler und Nenner kommen beim Auslesen vertauscht zurück: Nach GearRatioNumerator = 0.02 und GearRatioDenominator = 0.04 liefert die Definition 0,04 : 0,02.
Eigenschaften und Methoden
Eigenschaften 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| EntitiesToMate | Liest oder setzt die beiden Elemente der Zahnradverknüpfung: zylindrische oder kegelige Flächen, Achsen oder gerade Kanten. |
| GearRatioDenominator | Liest oder setzt den Nenner des Übersetzungsverhältnisses der Zahnradverknüpfung. |
| GearRatioNumerator | Liest oder setzt den Zähler des Übersetzungsverhältnisses der Zahnradverknüpfung. |
| Reverse | Liest oder setzt, ob die Zahnradverknüpfung die Drehrichtung der Zahnräder zueinander umkehrt. |
Siehe auch
Englisches Original: IGearMateFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.