Objekt · SldWorks
BlockInstance-Objekt
Veraltetes Objekt für einen eingefügten Block in einer Zeichnung. Seit SOLIDWORKS 2007 tritt SketchBlockInstance an seine Stelle.
Beschreibung
BlockInstance ist veraltet und durch SketchBlockInstance ersetzt. Das Objekt stand für einen eingefügten Block in einer Zeichnung, also eine Blockinstanz einer BlockDefinition mit eigener Lage, eigenem Winkel und Maßstab. 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
View.GetFirstBlockInstanceund dannBlockInstance.GetNext: die Blockinstanzen einer Zeichenansicht (veraltet)BlockDefinition.GetBlockInstances: die Blockinstanzen einer Blockdefinition (veraltet)BlockDefinition.InsertInstanceundDrawingDoc.InsertBlock: einen Block einfügen (veraltet)
Beispiel
' Gibt für jede Blockinstanz des aktiven Dokuments Name, Winkel, Maßstab und Attribute aus.
' Vorbedingung: Ein Dokument mit eingefügten 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 vInstanzen As Variant
Dim vAttribute As Variant
Dim swBlockDef As SldWorks.SketchBlockDefinition
Dim swBlockInst As SldWorks.SketchBlockInstance
Dim swNote As SldWorks.Note
Dim i As Long, j As Long, k As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
vBloecke = swModel.SketchManager.GetSketchBlockDefinitions
If Not IsArray(vBloecke) Then Exit Sub
For i = 0 To UBound(vBloecke)
Set swBlockDef = vBloecke(i)
vInstanzen = swBlockDef.GetInstances ' statt GetBlockInstances
If IsArray(vInstanzen) Then
For j = 0 To UBound(vInstanzen)
Set swBlockInst = vInstanzen(j)
Debug.Print swBlockInst.Name
Debug.Print " Winkel: " & swBlockInst.Angle * 57.2957795 & " Grad" ' Bogenmaß in Grad
Debug.Print " Maßstab: " & swBlockInst.GetScale3(False) ' statt Scale2 lesen
vAttribute = swBlockInst.GetAttributes
If IsArray(vAttribute) Then
For k = 0 To UBound(vAttribute)
Set swNote = vAttribute(k)
Debug.Print " " & swNote.TagName & " = " & swNote.GetText
Next k
End If
Next j
End If
Next i
End SubBemerkungen
Ersatz: Die Hilfe nennt für die meisten Befehle einen Nachfolger an SketchBlockInstance:
- Definition:
SketchBlockInstance.Definition, die Blockdefinition ist dann eineSketchBlockDefinition. - Angle:
SketchBlockInstance.Angle, im Bogenmaß (30° ergaben 0,5236). Ändern kannst du den Winkel nur, während du die Skizze des Blocks bearbeitest. - Scale2: SketchBlockInstance.Scale, das selbst veraltet ist. Heute setzt du den Maßstab mit
SketchBlockInstance.Scale2und liest ihn mitSketchBlockInstance.GetScale3. - TextDisplay:
SketchBlockInstance.TextDisplaymit Werten ausswBlockInstanceTextDisplay_e. - GetAttributes, GetAttributeCount, GetAttributeValue und SetAttributeValue: die gleichnamigen Befehle
SketchBlockInstance.GetAttributes,SketchBlockInstance.GetAttributeCount,SketchBlockInstance.GetAttributeValueundSketchBlockInstance.SetAttributeValue. - GetAnnotation und GetNext: ohne Nachfolger. Die Blockinstanzen bekommst du über
SketchBlockDefinition.GetInstancesoder, je Skizze, überSketch.GetSketchBlockInstances. Der alte Weg über View.GetFirstBlockInstance lieferte in SOLIDWORKS 2024 auf einem Blatt mit vier Blockinstanzen nurNothing, ohne Fehler.
Attribute: Bei SketchBlockInstance sind Attribute Notizen mit Tag-Namen, die nicht schreibgeschützt sind. Das Hilfebeispiel liest sie deshalb als Note mit Note.TagName und Note.GetText. Eine gewöhnliche Notiz im Block zählt nicht als Attribut. Erst wenn du vor dem Bilden des Blocks ihren Note.TagName setzt, liefern SketchBlockInstance.GetAttributeCount 1 und SketchBlockInstance.GetAttributeValue ihren Text. SketchBlockInstance.SetAttributeValue ändert ihn und meldet dabei 1 statt -1 für True, prüf das Ergebnis deshalb mit If False = ….
Einfügen: Statt BlockDefinition.InsertInstance und DrawingDoc.InsertBlock nimmst du SketchManager.InsertSketchBlockInstance.
Getestet: Das Beispiel lief in SOLIDWORKS 2024 an einer Zeichnung mit drei Blöcken und vier Blockinstanzen. Die mit Winkel 30° und Maßstab 2 eingefügte Instanz „Block1-2“ ergab „Winkel: 30 Grad“ und „Maßstab: 2“, die Instanz des Blocks mit der Notiz mit Tag-Namen NR gab „NR = 123“ aus.
Eigenschaften und Methoden
Eigenschaften 4, davon 0 beschrieben, 4 veraltet
| Name | Beschreibung |
|---|---|
| Angle | veraltet ersetzt durch SketchBlockInstance.Angle |
| Definition | veraltet ersetzt durch SketchBlockInstance.Definition |
| Scale2 | veraltet ersetzt durch SketchBlockInstance.Scale2 |
| TextDisplay | veraltet ersetzt durch SketchBlockInstance.TextDisplay |
Methoden 6, davon 0 beschrieben, 6 veraltet
| Name | Beschreibung |
|---|---|
| GetAnnotation | veraltet |
| GetAttributeCount | veraltet ersetzt durch SketchBlockInstance.GetAttributeCount |
| GetAttributes | veraltet ersetzt durch SketchBlockInstance.GetAttributes |
| GetAttributeValue | veraltet ersetzt durch SketchBlockInstance.GetAttributeValue |
| GetNext | veraltet |
| SetAttributeValue | veraltet ersetzt durch SketchBlockInstance.SetAttributeValue |
Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetAttributes). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IBlockInstance in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.