SolidWorksMakroprogrammierung

Objekt · SldWorks

CThread-Objekt

Eine Gewindedarstellung in einer Zeichnungsansicht, mit ihrer Beschriftung und den Kopien aus Mustern.

Deklaration Dim x As SldWorks.CThread · in der englischen .NET-Hilfe: ICThread

Beschreibung

CThread gibt Zugriff auf eine Gewindedarstellung (kosmetisches Gewinde) in einer Zeichnung. Sie gehört meist zu einem Feature „Gewindedarstellung“ im Modell, und ihre Beschriftung trägt denselben Namen wie das Feature. Die Daten des Gewindes selbst stehen in CosmeticThreadFeatureData.

Zugriff

Beispiel

' Geht alle Zeichnungsansichten durch und gibt für jede Gewindedarstellung Name,
' Beschriftungstext und die Zahl der Kopien aus Mustern aus.
' Vorbedingung: Eine Zeichnung mit Gewindedarstellungen ist offen.
' Ergebnis:     Die Gewindedarstellungen stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swView As SldWorks.View
    Dim swGewinde As SldWorks.CThread
    Dim swNotiz As SldWorks.Note

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub
    Set swDraw = swModel

    Set swView = swDraw.GetFirstView                           ' zuerst das Blatt
    Set swView = swView.GetNextView                            ' dann die Ansichten
    Do While Not swView Is Nothing
        Set swGewinde = swView.GetFirstCThread
        Do While Not swGewinde Is Nothing
            Set swNotiz = swGewinde.ThreadCallout
            Debug.Print swView.Name & ": " & swGewinde.GetAnnotation.GetName & ", " & _
                        swGewinde.GetPatternedTransformsCount & " Kopien"
            If Not swNotiz Is Nothing Then Debug.Print "  Beschriftung: " & swNotiz.GetText
            Set swGewinde = swGewinde.GetNext
        Loop
        Set swView = swView.GetNextView
    Loop
End Sub

Bemerkungen

Vom Gewinde in der Zeichnung zum Feature: Mit Annotation.GetName holst du den Namen der Beschriftung. Mit diesem Namen findest du das Feature im Modell, etwa mit PartDoc.FeatureByName, und liest dann seine CosmeticThreadFeatureData.

Blatt überspringen: DrawingDoc.GetFirstView liefert zuerst das Blatt. Das Hilfebeispiel „Get Patterned Cosmetic Thread Annotations Data“ überspringt es über den Namen Sheet1, das Beispiel hier nimmt gleich die nächste Ansicht.

Muster: CThread.PatternedTransforms liefert nur die Kopien, nicht die Gewindedarstellung selbst. Ohne Muster ist das Array leer.

Eigenschaften und Methoden

Eigenschaften 2, davon 2 beschrieben

NameBeschreibung
PatternedTransformsLiefert die Transformationen aller Kopien der Gewindedarstellung, die durch Muster entstanden sind.
ThreadCalloutLiefert die Notiz, mit der die Gewindedarstellung in der Zeichnung beschriftet ist.

Methoden 4, davon 4 beschrieben

NameBeschreibung
GetAnnotationLiefert die Beschriftung (Annotation), zu der die Gewindedarstellung gehört.
GetDisplayDataLiefert die Darstellungsdaten der Gewindedarstellung.
GetNextLiefert die nächste Gewindedarstellung in der Zeichnungsansicht.
GetPatternedTransformsCountLiefert die Zahl der Kopien der Gewindedarstellung, die durch Muster entstanden sind.

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

Siehe auch

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

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