SolidWorksMakroprogrammierung

Objekt · SldWorks

RackPinionMateFeatureData-Objekt

Die Daten einer Verknüpfung Zahnstange und Ritzel in einer Baugruppe: die Elemente von Zahnstange und Ritzel, die Übersetzung und die Richtung.

Deklaration Dim x As SldWorks.RackPinionMateFeatureData · in der englischen .NET-Hilfe: IRackPinionMateFeatureData

Beschreibung

Eine Verknüpfung Zahnstange und Ritzel besteht aus zwei Komponenten: Die Zahnstange dreht das Ritzel und umgekehrt. Zähne brauchen die Komponenten nicht. RackPinionMateFeatureData hält die Daten der Verknüpfung. Übergeordnet ist MateFeatureData. Die Befehle gibt es seit SOLIDWORKS 2019.

Zugriff

Beispiel

' Legt eine Verknüpfung Zahnstange und Ritzel an. Das Ritzel hat einen
' Teilkreisdurchmesser von 25,4 mm.
' Vorbedingung: Eine Baugruppe ist offen. Ausgewählt sind zuerst eine gerade Kante
'               der Zahnstange, dann eine zylindrische Fläche des Ritzels.
' 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 swDaten As SldWorks.RackPinionMateFeatureData
    Dim swFeat As SldWorks.Feature
    Dim swSelData As SldWorks.SelectData
    Dim swZahnstange As SldWorks.Entity
    Dim swRitzel As SldWorks.Entity

    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 Kante der Zahnstange und Fläche des Ritzels auswählen."
        Exit Sub
    End If
    Set swZahnstange = swSelMgr.GetSelectedObject6(1, -1)
    Set swRitzel = swSelMgr.GetSelectedObject6(2, -1)

    ' Neu auswählen mit den Markierungen 64 (Zahnstange) und 128 (Ritzel) wie im Hilfebeispiel;
    ' EntitiesToMate ließ sich in SOLIDWORKS 2024 nicht setzen
    swModel.ClearSelection2 True
    Set swSelData = swSelMgr.CreateSelectData
    swSelData.Mark = 64
    swZahnstange.Select4 False, swSelData
    swSelData.Mark = 128
    swRitzel.Select4 True, swSelData

    Set swDaten = swAssy.CreateMateData(swMateRACKPINION)
    swDaten.DiameterType = swPinionPitchDiameter
    swDaten.DiameterVal = 0.0254                        ' 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. Die Elemente setzt du mit RackPinionMateFeatureData.EntitiesToMate oder wählst sie vorher mit ModelDocExtension.SelectByID2 aus: die Zahnstange mit der Markierung 64, das Ritzel mit 128. 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 RackPinionMateFeatureData zu. Dann änderst du die Werte und rufst Feature.ModifyDefinition auf. Löschen geht mit ModelDocExtension.DeleteSelection2.

Hilfebeispiel: Das VBA-Beispiel der Hilfe öffnet Rack And Pinion.sldasm aus den Lernbeispielen, wählt die Elemente mit ModelDocExtension.SelectByRay und den Markierungen 64 und 128 aus und ruft CreateMateData und CreateMate über eine Variable vom Typ ModelDoc2 mit der Zahl 13 auf. EntitiesToMate setzt es nicht. Es setzt DiameterType = 0 (swPinionPitchDiameter), DiameterVal = 0.0254 und Reverse = False. Das Beispiel hier setzt die Elemente stattdessen mit EntitiesToMate. Ob die Eigenschaft dafür ein Array mit einem Element annimmt, zeigt die Hilfe nicht.

Übersetzung: Die Zahnstange legt je voller Umdrehung des Ritzels den Weg Pi mal Teilkreisdurchmesser zurück. Für DiameterVal nennt die Hilfe keine Einheit, vermutlich Meter.

RackPinionMateFeatureData.EntitiesToMate lässt sich in VBA nicht verwenden: Das Setzen scheitert schon beim Kompilieren mit „Typen unverträglich“, über eine Variant-Variable mit Laufzeitfehler 424. Wähle die Elemente deshalb vor AssemblyDoc.CreateMate mit den Markierungen 64 (Zahnstange) und 128 (Ritzel) aus.

Eigenschaften und Methoden

Eigenschaften 4, davon 4 beschrieben

NameBeschreibung
DiameterTypeLiest oder setzt, was DiameterVal angibt: den Teilkreisdurchmesser des Ritzels oder den Weg der Zahnstange je Umdrehung des Ritzels.
DiameterValLiest oder setzt den Teilkreisdurchmesser des Ritzels oder den Weg der Zahnstange je Umdrehung des Ritzels.
EntitiesToMateLiest oder setzt die Elemente der Zahnstange oder des Ritzels.
ReverseLiest oder setzt, ob die Verknüpfung die Bewegungsrichtung von Zahnstange und Ritzel zueinander umkehrt.

Siehe auch

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

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