SolidWorksMakroprogrammierung

Objekt · SldWorks

CosmeticThreadFeatureData-Objekt

Die Definition einer Gewindedarstellung: Kante, Tiefe, Durchmesser, Norm, Größe, Beschriftung und Konfigurationen.

Deklaration Dim x As SldWorks.CosmeticThreadFeatureData · in der englischen .NET-Hilfe: ICosmeticThreadFeatureData

Beschreibung

CosmeticThreadFeatureData gibt Zugriff auf eine Gewindedarstellung (kosmetisches Gewinde). Sie zeigt ein Gewinde an einer Kreiskante, ohne die Geometrie zu ändern, und liefert die Beschriftung für Zeichnungen. Im Teil oder in der Baugruppe ist eine Gewindedarstellung ein Unter-Feature einer Bohrung oder eines Schnitts. Die Angaben zu Norm, Größe, Endbedingung und Konfigurationen gibt es seit SOLIDWORKS 2015, die übrigen Befehle seit 2003.

Zugriff

Beispiel

' Sucht unter allen Features nach Gewindedarstellungen und gibt Norm, Größe, Durchmesser,
' Tiefe und Beschriftung aus.
' Vorbedingung: Ein Teil mit Gewindedarstellungen ist offen.
' Ergebnis:     Die Gewindedarstellungen stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature
    Dim swSubFeat As SldWorks.Feature
    Dim swDaten As SldWorks.CosmeticThreadFeatureData
    Dim sTiefe As String

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    Set swFeat = swModel.FirstFeature
    Do While Not swFeat Is Nothing
        Set swSubFeat = swFeat.GetFirstSubFeature
        Do While Not swSubFeat Is Nothing
            If swSubFeat.GetTypeName2 = "CosmeticThread" Then
                Set swDaten = swSubFeat.GetDefinition
                Select Case swDaten.EndCondition
                    Case swEndConditionThrough: sTiefe = "durch alles"
                    Case swEndConditionBlindUptoNext: sTiefe = "bis zum nächsten Element"
                    Case Else: sTiefe = Format(swDaten.BlindDepth * 1000, "0.0") & " mm"
                End Select
                Debug.Print swSubFeat.Name & " an " & swFeat.Name & ": " & swDaten.StandardType & " " & _
                            swDaten.Size & ", Durchmesser " & Format(swDaten.Diameter * 1000, "0.00") & _
                            " mm, Tiefe " & sTiefe
                Debug.Print "  Beschriftung: " & swDaten.ThreadCallout
            End If
            Set swSubFeat = swSubFeat.GetNextSubFeature
        Loop
        Set swFeat = swFeat.GetNextFeature
    Loop
End Sub

Bemerkungen

Unter-Features: Eine Gewindedarstellung ist ein Unter-Feature einer Bohrung oder eines Schnitts. Deshalb geht das Beispiel wie das Hilfebeispiel „Traverse All Cosmetic Threads“ auch durch die Unter-Features (Feature.GetFirstSubFeature, Feature.GetNextSubFeature).

Anlegen: Eine neue Gewindedarstellung legst du mit FeatureManager.InsertCosmeticThread3 an einer ausgewählten Kreiskante an.

Ändern: Nach CosmeticThreadFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du CosmeticThreadFeatureData.ReleaseSelectionAccess auf. Für CosmeticThreadFeatureData.Edge ist AccessSelections nach Angabe der Hilfe nötig, die übrigen Werte liest das Hilfebeispiel auch ohne.

Zwei Arten der Tiefe: Die ältere CosmeticThreadFeatureData.ApplyThread und die seit 2015 vorhandene CosmeticThreadFeatureData.EndCondition beschreiben beide, wie weit das Gewinde reicht, mit verschiedenen Werten. Wie sie zusammenhängen, sagt die Hilfe nicht.

Einheiten: Durchmesser und Tiefe sind Meter (0,017 und 0,02 aus InsertCosmeticThread3 erschienen als 17 und 20 mm). Das Hilfebeispiel rechnet sie mit 1000 in Millimeter um.

Ohne Norm liefern StandardType und Size leere Werte.

Eigenschaften und Methoden

Eigenschaften 14, davon 14 beschrieben

NameBeschreibung
ApplyThreadLiest oder setzt, wie weit die Gewindedarstellung reicht: feste Tiefe, bis zur nächsten Fläche oder durch das ganze Objekt.
BlindDepthLiest oder setzt die Tiefe einer Gewindedarstellung mit fester Tiefe.
ConfigurationNamesLiest oder setzt die Namen der Konfigurationen, für die die Gewindedarstellung gilt.
ConfigurationOptionLiest oder setzt, für welche Konfigurationen die Gewindedarstellung gilt: nur die aktuelle, alle oder bestimmte.
DiameterLiest oder setzt den Durchmesser der Gewindedarstellung oder bei konischen Bohrungen ihren Versatz von der Kante.
DiameterTypeLiefert, welcher Durchmesser für die Gewindedarstellung gilt: Außen-, Kerndurchmesser oder Versatz bei konischer Bohrung.
EdgeLiest oder setzt die Kreiskante, an der die Gewindedarstellung sitzt.
EndConditionLiest oder setzt, wie tief die Gewindedarstellung reicht: feste Tiefe, bis zum nächsten Element, durch alles oder doppelter Durchmesser.
PatternedTransformsLiefert die Transformationen aller Kopien der Gewindedarstellung, die durch Muster entstanden sind.
SizeLiest oder setzt die Gewindegröße der Gewindedarstellung, etwa M10.
StandardLiest oder setzt die Norm der Gewindedarstellung, etwa ISO, DIN oder ANSI.
StandardTypeLiest oder setzt die Gewindeart innerhalb der Norm, etwa „Helicoil threads“.
StartFromFacePlaneLiest oder setzt die Fläche oder Ebene, an der die Gewindedarstellung beginnt.
ThreadCalloutLiest oder setzt den Text, mit dem die Gewindedarstellung in einer Zeichnung beschriftet wird.

Methoden 3, davon 3 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Gewindedarstellung zurück, damit du Kante und Startfläche lesen und sie ändern kannst.
GetPatternedTransformsCountLiefert die Zahl der Kopien der Gewindedarstellung, die durch Muster entstanden sind.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Gewindedarstellung nicht geändert hast.

Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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