Objekt · SldWorks
ThreadFeatureData-Objekt
Die Definition eines Gewinde-Features: Startkante, Gewindeprofil und Größe, Steigung, Durchmesser, Endbedingung, Versatz, Drehrichtung und mehrgängige Gewinde.
Beschreibung
ThreadFeatureData gibt Zugriff auf ein Gewinde-Feature (thread). Es erzeugt ein echtes, modelliertes Gewinde in einer zylindrischen Bohrung oder um einen zylindrischen Stab, anders als die Gewindedarstellung (CosmeticThreadFeatureData). Das Objekt entspricht dem PropertyManager Gewinde. Das Profil kommt aus einer Gewindeprofil-Datei (*.sldlfp), das Gewinde läuft als Helix von einer Startkante bis zu einer Endbedingung. Die Befehle gibt es seit SOLIDWORKS 2018.
Zugriff
FeatureManager.CreateDefinitionmitswFmSweepThread: eine neue Definition fürFeatureManager.CreateFeatureFeature.GetDefinition: bei einem Feature mit dem TypnamenSweepThread
Beispiel
' Gibt die wichtigsten Werte des ausgewählten Gewinde-Features aus und setzt eine
' eigene Steigung von 1,5 mm.
' Vorbedingung: Ein Teil mit einem Gewinde-Feature ist offen, das Feature ist im
' FeatureManager ausgewählt.
' Ergebnis: Das Gewinde hat die neue Steigung, die alten Werte stehen im Direktfenster.
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.ThreadFeatureData
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 <> "SweepThread" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swFeat.Name & ": " & swDaten.Type & ", " & swDaten.Size
Debug.Print " Methode " & swDaten.ThreadMethod & ", Endbedingung " & swDaten.EndCondition & _
", rechtsgängig " & swDaten.RightHanded
Debug.Print " Steigung " & swDaten.Pitch * 1000 & " mm (eigene: " & swDaten.PitchOverride & ")"
swDaten.PitchOverride = True
swDaten.Pitch = 0.0015
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End SubBemerkungen
Anlegen: Das Programmierhandbuch („Thread Features and ThreadFeatureData Objects“) nennt ein Teil mit einer Bohrung aus dem Bohrungsassistenten, einer erweiterten Bohrung oder einem Schnitt-Linear und Gewindeprofile im Ordner unter Extras, Optionen, Dateispeicherorte. Im Test genügte die Kreiskante einer extrudierten Welle. Dann: Definition mit FeatureManager.CreateDefinition und swFmSweepThread holen, ThreadFeatureData.InitializeThreadData aufrufen, die Startkante und gegebenenfalls die Bezugsfläche für die Endbedingung mit ModelDocExtension.SelectByRay und Markierung 1 auswählen, einen eigenen Startpunkt mit Markierung 2. Diese setzt du mit ThreadFeatureData.Edge, ThreadFeatureData.SetEndConditionReference und ThreadFeatureData.StartEntity, dann die übrigen Werte, und legst das Feature mit FeatureManager.CreateFeature an. So macht es das Hilfebeispiel „Create a Thread Feature“.
Ändern: Feature.GetDefinition, dann ThreadFeatureData.AccessSelections, Werte setzen und Feature.ModifyDefinition aufrufen. Änderst du nichts, rufst du ThreadFeatureData.ReleaseSelectionAccess auf.
Werte oder Gleichungen: Bei mehreren Zahlenwerten schreibt die Hilfe, du könntest einen Wert oder eine Gleichung mit = am Anfang angeben. Die Eigenschaften sind aber als Double deklariert. Wie eine Gleichung übergeben wird, sagt die Hilfe nicht.
Einheiten: Der Vorgabewert der Tiefe ist 0,01 m, Längen sind also Meter. Die Winkel sind in Bogenmaß. Für Steigung, Durchmesser und Versatz nennt die Hilfe keine Einheit. Die Versätze sind Meter (ein Versatz von 0,002 änderte die Gewindelänge um 2 mm, das Volumen um 27 mm³ bei 13,4 mm³ je mm Gewinde), für Steigung und Durchmesser vermutlich auch.
Eigenschaften und Methoden
Eigenschaften 30, davon 30 beschrieben
| Name | Beschreibung |
|---|---|
| BlindDepth | Liest oder setzt die Tiefe des Gewindes bei der Endbedingung Blind, einschließlich Versatz. |
| Diameter | Liest oder setzt den Durchmesser der Zylinderfläche oder Helix des Gewindes. |
| DiameterOverride | Liest oder setzt, ob das Gewinde einen eigenen Durchmesser bekommt. |
| Edge | Liest oder setzt die Kante, an der die Helix des Gewindes beginnt. |
| EndCondition | Liest oder setzt, wo das Gewinde endet: nach einer Tiefe, nach Umdrehungen oder an einer Auswahl. |
| EndConditionOffset | Liest oder setzt, ob das Ende des Gewindes gegenüber der gewählten Endbedingung versetzt wird. |
| EndConditionOffsetDistance | Liest oder setzt, um wie viel das Ende des Gewindes gegenüber der Auswahl versetzt wird. |
| EndConditionOffsetReverse | Liest oder setzt, ob der Versatz am Ende auf die andere Seite des Bezugs umgeklappt wird. |
| MaintainThreadLength | Liest oder setzt, ob das Gewinde ab der Startfläche seine Länge behält, wenn der Anfang versetzt ist. |
| MirrorProfile | Liest oder setzt, ob das Profil der Gewindehelix um seine waagerechte oder senkrechte Achse gespiegelt wird. |
| MirrorType | Liest oder setzt, um welche Achse das Profil der Gewindehelix gespiegelt wird. |
| MultipleStart | Liest oder setzt, ob das Gewinde mehrgängig ist. |
| NumberOfStarts | Liest oder setzt die Zahl der Gänge eines mehrgängigen Gewindes. |
| Offset | Liest oder setzt, ob der Anfang der Gewindehelix versetzt wird. |
| OffsetDistance | Liest oder setzt, um wie viel der Anfang der Gewindehelix versetzt wird. |
| Pitch | Liest oder setzt die Steigung der Gewindehelix. |
| PitchOverride | Liest oder setzt, ob das Gewinde eine eigene Steigung bekommt. |
| ProfileLocation | Liest oder setzt den Punkt in der Profilskizze des Gewindes, an dem die Helix beginnt. |
| ReverseDirection | Liest oder setzt, ob die Richtung bei den Endbedingungen Blind und Umdrehungen umgekehrt wird. |
| ReverseOffset | Liest oder setzt, ob der Versatz am Anfang der Helix auf die andere Seite der Startfläche umgeklappt wird. |
| Revolutions | Liest oder setzt die Zahl der Umdrehungen der Gewindehelix, einschließlich Versatz. |
| RightHanded | Liest oder setzt, ob das Gewinde rechtsgängig (im Uhrzeigersinn) gewunden ist. |
| RotationAngle | Liest oder setzt den Drehwinkel der Gewindehelix. |
| Size | Liest oder setzt die Größe des Gewindes, wie im PropertyManager Gewinde. |
| StartEntity | Liest oder setzt das Element, an dem die Helix des Gewindes beginnt, wenn die Startkante keine ebene Kreiskante ist. |
| ThreadMethod | Liest oder setzt, ob das Gewinde ausgeschnitten oder aufgesetzt (extrudiert) wird. |
| ThreadStartAngle | Liest oder setzt den Startwinkel des Gewindes. |
| TrimEndFace | Liest oder setzt, ob das Gewinde an der Endfläche bündig abgeschnitten wird. |
| TrimStartFace | Liest oder setzt, ob das Gewinde an der Startfläche bündig abgeschnitten wird. |
| Type | Liest oder setzt das Gewindeprofil, also die Profildatei (*.sldlfp). |
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Gewinde-Feature zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetEndConditionReference | Liefert den Bezug der Endbedingung bis zur Auswahl. |
| InitializeThreadData | Setzt alle Werte der Gewinde-Definition auf ihre Vorgabewerte. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Gewinde-Feature nicht geändert hast. |
| SetEndConditionReference | Setzt den Bezug der Endbedingung bis zur Auswahl. |
Siehe auch
Englisches Original: IThreadFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.