Objekt · SldWorks
BlockDefinition-Objekt
Veraltetes Objekt für die Definition eines Blocks in einer Zeichnung. Seit SOLIDWORKS 2007 tritt SketchBlockDefinition an seine Stelle.
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
DrawingDoc.GetBlockDefinitionsundDrawingDoc.GetBlockDefinition: die Blockdefinitionen einer Zeichnung (veraltet)DrawingDoc.MakeBlockDefinitionundDrawingDoc.CreateBlockDefinition: eine neue Blockdefinition (veraltet)BlockInstance.Definition: die Definition eines eingefügten Blocks (veraltet)
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 SubBemerkungen
Ersatz: Die Hilfe nennt für fast jeden Befehl einen Nachfolger an SketchBlockDefinition oder am SketchManager:
- GetBlockInstances und GetBlockInstanceCount:
SketchBlockDefinition.GetInstancesundSketchBlockDefinition.GetInstanceCount, die Blockinstanzen sind dannSketchBlockInstance. - InsertInstance:
SketchManager.InsertSketchBlockInstance. - GetBasePoint und SetBasePoint:
SketchBlockDefinition.InsertionPoint, einMathPointstatt eines Arrays. - GetSketch:
SketchBlockDefinition.GetSketch. - GetDimensions und GetDimensionCount:
SketchBlockDefinition.GetDisplayDimensionsundSketchBlockDefinition.GetDisplayDimensionCount, die Bemaßungen sind dannDisplayDimension. - GetNotes und GetNoteCount:
SketchBlockDefinition.GetNotesundSketchBlockDefinition.GetNoteCount. - GetExternalFileName und SetExternalFileName:
SketchBlockDefinition.FileName. - GetUseExternalFile und SetUseExternalFile:
SketchBlockDefinition.LinkToFile. - Name: ohne Nachfolger. Das Feature aus
SketchBlockDefinition.GetFeatureträgt den Namen des Blocks, so wie er im FeatureManager steht, etwa „Block1“ oder bei einem Block aus einer Datei deren Name. Die Instanzen heißen dann „Block1-1“ usw.
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
| Name | Beschreibung |
|---|---|
| Name | veraltet |
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.