SolidWorksMakroprogrammierung

Objekt · SldWorks

CommentFolder-Objekt

Der Ordner „Kommentare“ im FeatureManager mit allen Kommentaren des Dokuments.

Deklaration Dim x As SldWorks.CommentFolder · in der englischen .NET-Hilfe: ICommentFolder

Beschreibung

CommentFolder gibt Zugriff auf den Ordner „Kommentare“ im FeatureManager. Im Ordner stehen alle Kommentare (Comment) des Dokuments, auch die, die zu einem Feature gehören. Den Ordner bekommst du über sein Feature mit dem Typnamen CommentsFolder.

Zugriff

Beispiel

' Sucht den Ordner „Kommentare“, legt darin einen Kommentar mit dem heutigen Datum an
' und zeigt ihn im FeatureManager.
' Vorbedingung: Ein Teil oder eine Baugruppe ist offen.
' Ergebnis:     Im Ordner „Kommentare“ steht ein neuer Kommentar. Name und Zahl der
'               Kommentare stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature
    Dim swOrdner As SldWorks.CommentFolder
    Dim swKommentar As SldWorks.Comment

    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
        If swFeat.GetTypeName2 = "CommentsFolder" Then Exit Do
        Set swFeat = swFeat.GetNextFeature
    Loop
    If swFeat Is Nothing Then Exit Sub

    Set swOrdner = swFeat.GetSpecificFeature2
    Set swKommentar = swOrdner.AddComment("Geprüft am " & Format(Date, "dd.mm.yyyy"))
    If swKommentar Is Nothing Then Exit Sub
    swModel.FeatureManager.UpdateFeatureTree                   ' erst jetzt zu sehen
    Debug.Print swKommentar.Name & " angelegt, " & swOrdner.GetCommentCount & " Kommentare im Ordner"
End Sub

Bemerkungen

Versteckter Ordner: Das Hilfebeispiel zeigt: Es gibt das Feature des Ordners auch dann, wenn der FeatureManager den Ordner nicht zeigt. Sichtbar wird er, sobald er einen Kommentar enthält und du den FeatureManager mit FeatureManager.UpdateFeatureTree neu aufbaust.

Drei Wege zum Kommentar: CommentFolder.AddComment legt einen Kommentar an, der zu keinem Feature gehört, Feature.AddComment einen zu einem Feature. ModelDocExtension.AddComment richtet sich nach der Auswahl und wird beim Makro-Aufzeichnen benutzt. Sie baut den FeatureManager jedes Mal neu auf, was bei großen Bäumen dauert.

Eigenschaften und Methoden

Methoden 4, davon 4 beschrieben

NameBeschreibung
AddCommentFügt dem Ordner „Kommentare“ einen Kommentar hinzu, der zu keinem Feature gehört.
GetCommentCountLiefert die Zahl der Kommentare im Ordner.
GetCommentsLiefert alle Kommentare im Ordner.
GetFeatureLiefert das Feature des Ordners „Kommentare“.

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

Siehe auch

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

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