SolidWorksMakroprogrammierung

Objekt · SldWorks

BlockDefinition-Objekt

Veraltetes Objekt für die Definition eines Blocks in einer Zeichnung. Seit SOLIDWORKS 2007 tritt SketchBlockDefinition an seine Stelle.

Deklaration Dim x As SldWorks.BlockDefinition · in der englischen .NET-Hilfe: IBlockDefinition

Beschreibung

BlockDefinition ist veraltet und durch SketchBlockDefinition ersetzt. Das Objekt stand für die Definition eines Blocks in einer Zeichnung, also eine wiederverwendbare Gruppe aus Skizzenelementen, Bemaßungen und Notizen. Das Hilfebeispiel „Get Block Information“ nennt BlockDefinition und BlockInstance seit SOLIDWORKS 2007 veraltet und nicht mehr unterstützt. Es zeigt auch, wie du ein Makro auf die neuen Objekte umstellst.

Zugriff

Beispiel

' Gibt für jede Blockdefinition des aktiven Dokuments den Namen ihres Features,
' die Verknüpfung mit einer Datei und die Zahl der Blockinstanzen und Notizen aus.
' Vorbedingung: Ein Dokument mit Blöcken ist offen, etwa eine Zeichnung.
' Ergebnis:     Die Werte stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim vBloecke As Variant
    Dim swBlockDef As SldWorks.SketchBlockDefinition
    Dim i As Long

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

    vBloecke = swModel.SketchManager.GetSketchBlockDefinitions     ' statt DrawingDoc.GetBlockDefinitions
    If Not IsArray(vBloecke) Then Exit Sub
    For i = 0 To UBound(vBloecke)
        Set swBlockDef = vBloecke(i)
        Debug.Print swBlockDef.GetFeature.Name                       ' statt Name
        Debug.Print "  Mit Datei verknüpft: " & swBlockDef.LinkToFile  ' statt GetUseExternalFile
        If swBlockDef.LinkToFile Then Debug.Print "  Datei: " & swBlockDef.FileName   ' statt GetExternalFileName
        Debug.Print "  Blockinstanzen: " & swBlockDef.GetInstanceCount  ' statt GetBlockInstanceCount
        Debug.Print "  Notizen: " & swBlockDef.GetNoteCount
    Next i
End Sub

Bemerkungen

Ersatz: Die Hilfe nennt für fast jeden Befehl einen Nachfolger an SketchBlockDefinition oder am SketchManager:

Befehle der Zeichnung: Auch die Befehle von DrawingDoc für Blöcke sind veraltet. In SOLIDWORKS 2024 lieferte DrawingDoc.GetBlockDefinitions für eine Zeichnung mit zwei Blöcken nur Empty, ohne Fehler. Die neuen Blöcke findet nur noch der SketchManager. Statt DrawingDoc.GetBlockDefinitions nimmst du SketchManager.GetSketchBlockDefinitions, statt DrawingDoc.MakeBlockDefinition und DrawingDoc.CreateBlockDefinition eine der Methoden SketchManager.MakeSketchBlockFromFile, SketchManager.MakeSketchBlockFromSelected oder SketchManager.MakeSketchBlockFromSketch. Statt DrawingDoc.SaveBlock nimmst du SketchBlockDefinition.Save, statt DrawingDoc.GetEditBlock die Methoden SketchManager.EditSketchBlock und SketchManager.EndEditSketchBlock.

Nicht nur in Zeichnungen: Die neuen Befehle hängen am SketchManager, den jedes Dokument hat. Das Hilfebeispiel „Get Block Information“ arbeitet trotzdem mit einer Zeichnung.

Getestet: Das Beispiel lief in SOLIDWORKS 2024 an einer Zeichnung mit zwei Blöcken aus je vier Linien und einer Notiz. Der erste kam aus SketchManager.MakeSketchBlockFromSelected, der zweite verknüpft aus einer Blockdatei (SketchManager.MakeSketchBlockFromFile). Ausgegeben wurden „Block1“, nicht verknüpft, und „Schild“, verknüpft mit der Datei Schild.sldblk samt Pfad, je mit einer Blockinstanz und einer Notiz.

Eigenschaften und Methoden

Eigenschaften 1, davon 0 beschrieben, 1 veraltet

NameBeschreibung
Nameveraltet

Methoden 14, davon 0 beschrieben, 14 veraltet

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

Siehe auch

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

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