SolidWorksMakroprogrammierung

Objekt · SldWorks

ThreadFeatureData-Objekt

Die Definition eines Gewinde-Features: Startkante, Gewindeprofil und Größe, Steigung, Durchmesser, Endbedingung, Versatz, Drehrichtung und mehrgängige Gewinde.

Deklaration Dim x As SldWorks.ThreadFeatureData · in der englischen .NET-Hilfe: IThreadFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
BlindDepthLiest oder setzt die Tiefe des Gewindes bei der Endbedingung Blind, einschließlich Versatz.
DiameterLiest oder setzt den Durchmesser der Zylinderfläche oder Helix des Gewindes.
DiameterOverrideLiest oder setzt, ob das Gewinde einen eigenen Durchmesser bekommt.
EdgeLiest oder setzt die Kante, an der die Helix des Gewindes beginnt.
EndConditionLiest oder setzt, wo das Gewinde endet: nach einer Tiefe, nach Umdrehungen oder an einer Auswahl.
EndConditionOffsetLiest oder setzt, ob das Ende des Gewindes gegenüber der gewählten Endbedingung versetzt wird.
EndConditionOffsetDistanceLiest oder setzt, um wie viel das Ende des Gewindes gegenüber der Auswahl versetzt wird.
EndConditionOffsetReverseLiest oder setzt, ob der Versatz am Ende auf die andere Seite des Bezugs umgeklappt wird.
MaintainThreadLengthLiest oder setzt, ob das Gewinde ab der Startfläche seine Länge behält, wenn der Anfang versetzt ist.
MirrorProfileLiest oder setzt, ob das Profil der Gewindehelix um seine waagerechte oder senkrechte Achse gespiegelt wird.
MirrorTypeLiest oder setzt, um welche Achse das Profil der Gewindehelix gespiegelt wird.
MultipleStartLiest oder setzt, ob das Gewinde mehrgängig ist.
NumberOfStartsLiest oder setzt die Zahl der Gänge eines mehrgängigen Gewindes.
OffsetLiest oder setzt, ob der Anfang der Gewindehelix versetzt wird.
OffsetDistanceLiest oder setzt, um wie viel der Anfang der Gewindehelix versetzt wird.
PitchLiest oder setzt die Steigung der Gewindehelix.
PitchOverrideLiest oder setzt, ob das Gewinde eine eigene Steigung bekommt.
ProfileLocationLiest oder setzt den Punkt in der Profilskizze des Gewindes, an dem die Helix beginnt.
ReverseDirectionLiest oder setzt, ob die Richtung bei den Endbedingungen Blind und Umdrehungen umgekehrt wird.
ReverseOffsetLiest oder setzt, ob der Versatz am Anfang der Helix auf die andere Seite der Startfläche umgeklappt wird.
RevolutionsLiest oder setzt die Zahl der Umdrehungen der Gewindehelix, einschließlich Versatz.
RightHandedLiest oder setzt, ob das Gewinde rechtsgängig (im Uhrzeigersinn) gewunden ist.
RotationAngleLiest oder setzt den Drehwinkel der Gewindehelix.
SizeLiest oder setzt die Größe des Gewindes, wie im PropertyManager Gewinde.
StartEntityLiest oder setzt das Element, an dem die Helix des Gewindes beginnt, wenn die Startkante keine ebene Kreiskante ist.
ThreadMethodLiest oder setzt, ob das Gewinde ausgeschnitten oder aufgesetzt (extrudiert) wird.
ThreadStartAngleLiest oder setzt den Startwinkel des Gewindes.
TrimEndFaceLiest oder setzt, ob das Gewinde an der Endfläche bündig abgeschnitten wird.
TrimStartFaceLiest oder setzt, ob das Gewinde an der Startfläche bündig abgeschnitten wird.
TypeLiest oder setzt das Gewindeprofil, also die Profildatei (*.sldlfp).

Methoden 5, davon 5 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Gewinde-Feature zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetEndConditionReferenceLiefert den Bezug der Endbedingung bis zur Auswahl.
InitializeThreadDataSetzt alle Werte der Gewinde-Definition auf ihre Vorgabewerte.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Gewinde-Feature nicht geändert hast.
SetEndConditionReferenceSetzt 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.