SolidWorksMakroprogrammierung

Objekt · SldWorks

GearMateFeatureData-Objekt

Die Daten einer Zahnradverknüpfung in einer Baugruppe: die beiden Elemente, das Übersetzungsverhältnis und die Drehrichtung.

Deklaration Dim x As SldWorks.GearMateFeatureData · in der englischen .NET-Hilfe: IGearMateFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
EntitiesToMateLiest oder setzt die beiden Elemente der Zahnradverknüpfung: zylindrische oder kegelige Flächen, Achsen oder gerade Kanten.
GearRatioDenominatorLiest oder setzt den Nenner des Übersetzungsverhältnisses der Zahnradverknüpfung.
GearRatioNumeratorLiest oder setzt den Zähler des Übersetzungsverhältnisses der Zahnradverknüpfung.
ReverseLiest 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.