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.
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
Feature.GetDefinition: bei einem Feature mit dem TypnamenHelix
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 SubBemerkungen
Ä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
| Name | Beschreibung |
|---|---|
| Clockwise | Liest oder setzt, ob die Windungen der Helix im Uhrzeigersinn laufen. |
| DefinedBy | Liest oder setzt, womit die Helix festgelegt ist: Steigung und Umdrehungen, Höhe und Umdrehungen, Höhe und Steigung, oder ob sie eine Spirale ist. |
| Height | Liest oder setzt die Höhe der Helix. |
| Pitch | Liest oder setzt die Steigung der Helix oder den Abstand der Windungen einer Spirale. |
| PitchCount | Liefert die Zahl der Bereiche einer Helix mit variabler Steigung. |
| ReverseDirection | Liest oder setzt, ob die Helix vom Ursprung aus rückwärts verläuft oder die Spirale nach innen. |
| Revolution | Liest oder setzt die Zahl der Umdrehungen der Helix. |
| StartingAngle | Liest oder setzt den Winkel, bei dem die erste Windung der Helix beginnt. |
| Taper | Liest oder setzt, ob eine Helix mit fester Steigung verjüngt ist. |
| TaperAngle | Liest oder setzt den Verjüngungswinkel einer Helix mit fester Steigung. |
| TaperOutward | Liest oder setzt, ob sich eine Helix mit fester Steigung nach außen oder nach innen verjüngt. |
| VariablePitch | Liest, ob die Helix eine variable oder eine feste Steigung hat. |
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| AddLastRecord | Fügt am Ende der Tabelle der Bereichsparameter einer Helix mit variabler Steigung einen Bereich an. |
| DeleteRecord | Löscht Bereiche aus der Tabelle der Bereichsparameter einer Helix mit variabler Steigung. |
| GetRegionParameterAtIndex | Liefert einen Wert eines Bereichs einer Helix mit variabler Steigung: Steigung, Umdrehungen, Höhe oder Durchmesser. |
| InsertRecord | Fügt in die Tabelle der Bereichsparameter einer Helix mit variabler Steigung einen Bereich ein, dessen Werte SOLIDWORKS berechnet. |
| SetRegionParameterAtIndex | Setzt 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.