SolidWorksMakroprogrammierung

Objekt · SldWorks

BlockInstance-Objekt

Veraltetes Objekt für einen eingefügten Block in einer Zeichnung. Seit SOLIDWORKS 2007 tritt SketchBlockInstance an seine Stelle.

Deklaration Dim x As SldWorks.BlockInstance · in der englischen .NET-Hilfe: IBlockInstance

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

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 Sub

Bemerkungen

Ersatz: Die Hilfe nennt für die meisten Befehle einen Nachfolger an SketchBlockInstance:

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

NameBeschreibung
Angleveraltet ersetzt durch SketchBlockInstance.Angle
Definitionveraltet ersetzt durch SketchBlockInstance.Definition
Scale2veraltet ersetzt durch SketchBlockInstance.Scale2
TextDisplayveraltet ersetzt durch SketchBlockInstance.TextDisplay

Methoden 6, davon 0 beschrieben, 6 veraltet

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.