Objekt · SldWorks
CosmeticThreadFeatureData-Objekt
Die Definition einer Gewindedarstellung: Kante, Tiefe, Durchmesser, Norm, Größe, Beschriftung und Konfigurationen.
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
Feature.GetDefinition: bei einem Feature mit dem TypnamenCosmeticThread, meist ein Unter-Feature, sieheFeature.GetFirstSubFeature
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| ApplyThread | Liest oder setzt, wie weit die Gewindedarstellung reicht: feste Tiefe, bis zur nächsten Fläche oder durch das ganze Objekt. |
| BlindDepth | Liest oder setzt die Tiefe einer Gewindedarstellung mit fester Tiefe. |
| ConfigurationNames | Liest oder setzt die Namen der Konfigurationen, für die die Gewindedarstellung gilt. |
| ConfigurationOption | Liest oder setzt, für welche Konfigurationen die Gewindedarstellung gilt: nur die aktuelle, alle oder bestimmte. |
| Diameter | Liest oder setzt den Durchmesser der Gewindedarstellung oder bei konischen Bohrungen ihren Versatz von der Kante. |
| DiameterType | Liefert, welcher Durchmesser für die Gewindedarstellung gilt: Außen-, Kerndurchmesser oder Versatz bei konischer Bohrung. |
| Edge | Liest oder setzt die Kreiskante, an der die Gewindedarstellung sitzt. |
| EndCondition | Liest oder setzt, wie tief die Gewindedarstellung reicht: feste Tiefe, bis zum nächsten Element, durch alles oder doppelter Durchmesser. |
| PatternedTransforms | Liefert die Transformationen aller Kopien der Gewindedarstellung, die durch Muster entstanden sind. |
| Size | Liest oder setzt die Gewindegröße der Gewindedarstellung, etwa M10. |
| Standard | Liest oder setzt die Norm der Gewindedarstellung, etwa ISO, DIN oder ANSI. |
| StandardType | Liest oder setzt die Gewindeart innerhalb der Norm, etwa „Helicoil threads“. |
| StartFromFacePlane | Liest oder setzt die Fläche oder Ebene, an der die Gewindedarstellung beginnt. |
| ThreadCallout | Liest oder setzt den Text, mit dem die Gewindedarstellung in einer Zeichnung beschriftet wird. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Gewindedarstellung zurück, damit du Kante und Startfläche lesen und sie ändern kannst. |
| GetPatternedTransformsCount | Liefert die Zahl der Kopien der Gewindedarstellung, die durch Muster entstanden sind. |
| ReleaseSelectionAccess | Hebt 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.