SolidWorksMakroprogrammierung

Objekt · SldWorks

HelixFeatureData-Objekt

Die Feature-Daten einer Helix oder Spirale: Festlegung, Höhe, Steigung, Umdrehungen, Startwinkel, Drehsinn, Verjüngung und bei variabler Steigung die Bereiche.

Deklaration Dim x As SldWorks.HelixFeatureData · in der englischen .NET-Hilfe: IHelixFeatureData

Beschreibung

HelixFeatureData gibt Zugriff auf ein Helix-Feature, in SOLIDWORKS das Feature „Spirale/Helix“. Es kann eine Helix mit fester oder variabler Steigung oder eine ebene Spirale sein. Die meisten Befehle gibt es seit SOLIDWORKS 2003, die für die variable Steigung seit SOLIDWORKS 2015.

Zugriff

Eine neue Helix mit fester Steigung legst du mit ModelDoc2.InsertHelix an, eine mit variabler Steigung mit FeatureManager.InsertVariablePitchHelix, FeatureManager.AddVariablePitchHelixFirstPitchAndDiameter, FeatureManager.AddVariablePitchHelixSegment und FeatureManager.EndVariablePitchHelix. Diese Befehle nennt die Hilfe unter „See Also“.

Beispiel

' Gibt die Daten der ausgewählten Helix aus. Bei fester Steigung, die nicht über Höhe
' und Umdrehungen festgelegt ist, vergrößert es die Steigung um ein Viertel.
' Vorbedingung: Ein Teil mit einer Helix ist offen, die Helix ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster (Strg+G), die Steigung ist größer.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.HelixFeatureData
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "Helix" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    Debug.Print swFeat.Name & ": Festlegung " & swDaten.DefinedBy      ' swHelixDefinedBy_e
    If swDaten.VariablePitch Then
        For i = 1 To swDaten.PitchCount
            Debug.Print "Bereich " & i & ": Steigung " & _
                swDaten.GetRegionParameterAtIndex(i, swVariablePitchHelixRegionParameter_Pitch) * 1000 & " mm"
        Next i
    Else
        Debug.Print "Höhe " & swDaten.Height * 1000 & " mm, Steigung " & swDaten.Pitch * 1000 & _
                    " mm, Umdrehungen " & swDaten.Revolution
        If swDaten.DefinedBy <> swHelixDefinedByHeightAndRevolution Then
            swDaten.Pitch = 1.25 * swDaten.Pitch
            If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then Debug.Print "Helix nicht geändert"
        End If
    End If
End Sub

Bemerkungen

Ändern: Hole die Daten mit Feature.GetDefinition, ändere sie und rufe Feature.ModifyDefinition auf. AccessSelections gibt es bei HelixFeatureData nicht.

Festlegung: Was sich ändern lässt, hängt von HelixFeatureData.DefinedBy ab. Bei swHelixDefinedByPitchAndRevolution kannst du die Höhe nicht ändern, bei swHelixDefinedByHeightAndRevolution nicht die Steigung und bei swHelixDefinedByHeightAndPitch nicht die Umdrehungen.

Variable Steigung: Die Bereiche stehen in der Tabelle der Bereichsparameter (Region parameters). Das Hilfebeispiel „Create and Modify Variable-pitch Helix“ zählt sie von 1 bis HelixFeatureData.PitchCount, ändert Durchmesser, Höhe und Umdrehungen des zweiten Bereichs, löscht den letzten, fügt einen neuen am Ende an und übernimmt alles mit ModifyDefinition.

Hilfebeispiele: „Change Pitch of Helix“ vergrößert die Steigung der ausgewählten Helix um ein Viertel und gibt sie in Millimeter umgerechnet aus, so wie das Beispiel hier.

Einheiten: Die Hilfe nennt keine Einheiten. Ihre Beispiele rechnen Steigung, Höhe und Durchmesser wie Meter. Für Startwinkel und Verjüngungswinkel ist vermutlich das Bogenmaß gemeint.

Steigung, Höhe und Durchmesser sind in Metern.

Eigenschaften und Methoden

Eigenschaften 12, davon 12 beschrieben

NameBeschreibung
ClockwiseLiest oder setzt, ob die Windungen der Helix im Uhrzeigersinn laufen.
DefinedByLiest oder setzt, womit die Helix festgelegt ist: Steigung und Umdrehungen, Höhe und Umdrehungen, Höhe und Steigung, oder ob sie eine Spirale ist.
HeightLiest oder setzt die Höhe der Helix.
PitchLiest oder setzt die Steigung der Helix oder den Abstand der Windungen einer Spirale.
PitchCountLiefert die Zahl der Bereiche einer Helix mit variabler Steigung.
ReverseDirectionLiest oder setzt, ob die Helix vom Ursprung aus rückwärts verläuft oder die Spirale nach innen.
RevolutionLiest oder setzt die Zahl der Umdrehungen der Helix.
StartingAngleLiest oder setzt den Winkel, bei dem die erste Windung der Helix beginnt.
TaperLiest oder setzt, ob eine Helix mit fester Steigung verjüngt ist.
TaperAngleLiest oder setzt den Verjüngungswinkel einer Helix mit fester Steigung.
TaperOutwardLiest oder setzt, ob sich eine Helix mit fester Steigung nach außen oder nach innen verjüngt.
VariablePitchLiest, ob die Helix eine variable oder eine feste Steigung hat.

Methoden 5, davon 5 beschrieben

NameBeschreibung
AddLastRecordFügt am Ende der Tabelle der Bereichsparameter einer Helix mit variabler Steigung einen Bereich an.
DeleteRecordLöscht Bereiche aus der Tabelle der Bereichsparameter einer Helix mit variabler Steigung.
GetRegionParameterAtIndexLiefert einen Wert eines Bereichs einer Helix mit variabler Steigung: Steigung, Umdrehungen, Höhe oder Durchmesser.
InsertRecordFügt in die Tabelle der Bereichsparameter einer Helix mit variabler Steigung einen Bereich ein, dessen Werte SOLIDWORKS berechnet.
SetRegionParameterAtIndexSetzt einen Wert eines Bereichs einer Helix mit variabler Steigung: Steigung, Umdrehungen, Höhe oder Durchmesser.

Siehe auch

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

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