SolidWorksMakroprogrammierung

Objekt · SldWorks

BeltChainFeatureData-Objekt

Die Feature-Daten eines Riemens oder einer Kette in einer Baugruppe: Riemenscheiben, Durchmesser, Länge, Dicke und Riementeil.

Deklaration Dim x As SldWorks.BeltChainFeatureData · in der englischen .NET-Hilfe: IBeltChainFeatureData

Beschreibung

Hinter jedem Riemen und jeder Kette einer Baugruppe (Baugruppen-Feature Riemen/Kette) steckt ein BeltChainFeatureData-Objekt mit den Feature-Daten. Du liest die Daten mit Feature.GetDefinition und übernimmst Änderungen mit Feature.ModifyDefinition. Mit FeatureManager.CreateDefinition legst du einen neuen Riemen an. Alle Befehle gibt es seit SOLIDWORKS 2022.

Zugriff

Beispiel

' Gibt die Riemenscheiben, Länge und Dicke des ausgewählten Riemens aus
' und macht den Riemen danach 10 mm länger.
' Vorbedingung: Eine Baugruppe mit einem Riemen ist offen, der Riemen ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, der Riemen ist länger, die Scheiben haben sich verschoben.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swObj As Object
    Dim swFeat As SldWorks.Feature
    Dim swDef As Object
    Dim swRiemen As SldWorks.BeltChainFeatureData
    Dim vDurchm As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    Set swObj = swSelMgr.GetSelectedObject6(1, -1)
    If Not TypeOf swObj Is SldWorks.Feature Then Exit Sub
    Set swFeat = swObj
    Set swDef = swFeat.GetDefinition
    If Not TypeOf swDef Is SldWorks.BeltChainFeatureData Then Exit Sub
    Set swRiemen = swDef

    If False = swRiemen.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name
    vDurchm = swRiemen.PulleyDiameters
    For i = 0 To UBound(vDurchm)
        Debug.Print "  Scheibe " & i & ": " & vDurchm(i) * 1000 & " mm"
    Next i
    Debug.Print "  Länge: " & swRiemen.BeltLength * 1000 & " mm"
    If swRiemen.UseBeltThickness Then Debug.Print "  Dicke: " & swRiemen.BeltThickness * 1000 & " mm"

    swRiemen.DrivingLength = True                                  ' Länge vorgeben
    swRiemen.BeltLength = swRiemen.BeltLength + 0.01               ' 10 mm länger
    If False = swFeat.ModifyDefinition(swRiemen, swModel, Nothing) Then Debug.Print "Nicht geändert"
End Sub

Bemerkungen

Ändern: Du rufst erst BeltChainFeatureData.AccessSelections auf. Das setzt das Modell vor den Riemen zurück. Dann änderst du die Werte und übernimmst sie mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit BeltChainFeatureData.ReleaseSelectionAccess auf. So ändert auch das Hilfebeispiel Durchmesser, Länge und Dicke.

Neuer Riemen: Bei FeatureManager.CreateDefinition ist die Definition für Riemen und Ketten schon mit Vorgaben gefüllt. In SOLIDWORKS 2024 waren das Länge 0, DrivingLength, UseBeltThickness und CreateBeltPart False, EngageBelt True, keine Riemenscheiben. Das Hilfebeispiel wählt die zylindrischen Flächen zweier Scheiben aus, setzt Riemenscheiben, Durchmesser, Seiten, Riemenebene, Länge, Dicke, Riementeil und Eingriff und erstellt den Riemen mit FeatureManager.CreateFeature.

Drei Arrays: BeltChainFeatureData.PulleyComponents, BeltChainFeatureData.PulleyDiameters und BeltChainFeatureData.FlipSides gehören Eintrag für Eintrag zusammen. Gib ihnen deshalb immer gleich viele Einträge.

Länge und Dicke: BeltChainFeatureData.BeltLength kannst du nur mit BeltChainFeatureData.DrivingLength = True setzen. Dann verschieben sich die Riemenscheiben, wenn mindestens eine passend frei beweglich ist. BeltChainFeatureData.BeltThickness gilt nur mit BeltChainFeatureData.UseBeltThickness = True.

Einheiten: Längen und Durchmesser sind in Metern.

Typname und Auswahl: Der Typname des Features ist Belt (Feature.GetTypeName2). Das Beispiel oben prüft mit TypeOf, ob hinter dem ausgewählten Feature ein BeltChainFeatureData steckt.

Nicht verwechseln: SketchManager.CreateSketchBelt erzeugt einen Riemen als Element einer Skizze, nicht dieses Baugruppen-Feature.

Getestet: Das Beispiel lief in SOLIDWORKS 2024 an einer Baugruppe aus zwei Scheiben mit 20 mm Durchmesser im Abstand von 100 mm, die erste fixiert, die zweite frei. Der Riemen mit 2 mm Dicke entstand mit CreateDefinition und CreateFeature. Das Beispiel gab 20 mm, 20 mm, 269,1 mm Länge und 2 mm Dicke aus. Danach war der Riemen 10 mm länger, die zweite Scheibe stand bei 105 statt 100 mm.

Ohne BeltChainFeatureData.AccessSelections lieferte die Definition Länge, Dicke und Riemenebene, aber BeltChainFeatureData.PulleyDiameters und BeltChainFeatureData.PulleyComponents waren Empty.

Eigenschaften und Methoden

Eigenschaften 10, davon 10 beschrieben

NameBeschreibung
BeltLengthLiest oder setzt die Länge des Riemens, in Metern.
BeltLocationPlaneLiest oder setzt, wo die Ebene des Riemens liegt: an einer Referenzebene, einer Fläche oder einem Eckpunkt.
BeltThicknessLiest oder setzt die Dicke des Riemens, in Metern.
CreateBeltPartLiest oder setzt, ob SOLIDWORKS ein eigenes Teil mit der Skizze des Riemens anlegt.
DrivingLengthLiest oder setzt, ob du die Länge des Riemens vorgeben kannst. Die Riemenscheiben richten sich dann danach.
EngageBeltLiest oder setzt, ob der Riemen in die Riemenscheiben eingreift.
FlipSidesLiest oder setzt für jede Riemenscheibe, ob der Riemen auf ihrer anderen Seite läuft.
PulleyComponentsLiest oder setzt die Riemenscheiben des Riemens, etwa zylindrische Flächen, Achsen oder Zahnräder.
PulleyDiametersLiest oder setzt die Durchmesser der Riemenscheiben, in Metern.
UseBeltThicknessLiest oder setzt, ob du eine Dicke für den Riemen angibst.

Methoden 5, davon 5 beschrieben

NameBeschreibung
AccessBeltPartLiefert das Teil, das SOLIDWORKS für den Riemen angelegt hat.
AccessSelectionsSetzt das Modell vor den Riemen zurück, damit du die Auswahlen lesen und ändern kannst, die ihn festlegen.
GetMemberIndexLiefert, an welcher Stelle eine Riemenscheibe in den Arrays des Riemens steht.
ModifyMemberParametersÄndert für eine Riemenscheibe den Durchmesser und auf welcher Seite der Riemen läuft.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du den Riemen nicht geändert hast.

Siehe auch

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

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