SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchBlockDefinition-Objekt

Eine Blockdefinition: der Inhalt eines Blocks mit Skizze, Notizen und Bemaßungen, seine Blockinstanzen und die Verknüpfung mit einer Blockdatei.

Deklaration Dim x As SldWorks.SketchBlockDefinition · in der englischen .NET-Hilfe: ISketchBlockDefinition

Beschreibung

SketchBlockDefinition gibt Zugriff auf eine Blockdefinition. Ein Block ist eine wiederverwendbare Gruppe aus Skizzenelementen, Notizen und Bemaßungen. Du fügst ihn beliebig oft als Blockinstanz (SketchBlockInstance) ein. Die Hilfebeispiele nutzen Blöcke in Teilen, Baugruppen und Zeichnungen. Seit SOLIDWORKS 2007 ersetzt das Objekt die veraltete BlockDefinition.

Zugriff

Beispiel

' Gibt für jede Blockdefinition des aktiven Dokuments Namen, Blockdatei und Inhalt aus,
' dazu Name und Lage jeder Blockinstanz.
' Vorbedingung: Ein Teil, eine Baugruppe oder eine Zeichnung mit Blöcken ist offen.
' 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 vLage As Variant
    Dim swBlockDef As SldWorks.SketchBlockDefinition
    Dim swBlockInst As SldWorks.SketchBlockInstance
    Dim i As Long, j 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)
        Debug.Print swBlockDef.GetFeature.Name
        If swBlockDef.LinkToFile Then Debug.Print "  Datei: " & swBlockDef.FileName
        Debug.Print "  Inhalt: " & swBlockDef.GetLineCount & " Linien, " & swBlockDef.GetArcCount & _
                    " Bögen, " & swBlockDef.GetNoteCount & " Notizen"
        If swBlockDef.GetInstanceCount > 0 Then
            vInstanzen = swBlockDef.GetInstances
            For j = 0 To UBound(vInstanzen)
                Set swBlockInst = vInstanzen(j)
                vLage = swBlockInst.InstancePosition.ArrayData
                Debug.Print "  " & swBlockInst.Name & " bei " & Format(vLage(0) * 1000, "0.0") & _
                            " / " & Format(vLage(1) * 1000, "0.0") & " mm"
            Next j
        End If
    Next i
End Sub

Bemerkungen

Name: Eine Eigenschaft für den Namen gibt es nicht, obwohl die Übersicht der Hilfe einen Namen nennt. Das Hilfebeispiel „Get Block Information“ sagt ausdrücklich, dass der Name der alten BlockDefinition keinen Ersatz hat. Das Feature aus SketchBlockDefinition.GetFeature trägt den Namen des Blocks, das Beispiel oben gibt ihn aus.

Einfügepunkt: SketchBlockDefinition.InsertionPoint ist der Ursprung der Skizze des Blocks, beim Lesen also immer (0, 0, 0). Setzt du ihn, verschiebt SOLIDWORKS die Geometrie in der Skizze, die Blockinstanzen sehen danach gleich aus.

Blockdatei: Einen Block speicherst du mit SketchBlockDefinition.Save als .sldblk-Datei. Mit SketchBlockDefinition.FileName und SketchBlockDefinition.LinkToFile verknüpfst du ihn mit einer vorhandenen Blockdatei, auch mit einer DXF- oder DWG-Datei. Es reicht nicht, nur diese beiden zu setzen, um einen Block in eine neue Datei zu speichern.

Geometrie als Zahlen: SketchBlockDefinition.GetLines, SketchBlockDefinition.GetArcs, SketchBlockDefinition.GetEllipses, SketchBlockDefinition.GetParabolas, SketchBlockDefinition.GetUserPoints und die Befehle für Splines liefern dieselben Zahlen-Arrays wie die entsprechenden Befehle von Sketch, etwa Sketch.GetLines2. Die passenden Zählbefehle wie SketchBlockDefinition.GetLineCount sind für C++ gedacht. In VBA brauchst du sie, um das Array Element für Element durchzugehen. Mit Objekten statt Zahlen arbeitest du über SketchBlockDefinition.GetSketch und Sketch.GetSketchSegments.

Einheiten: Die Hilfeseiten nennen keine. Ihre Beispiele rechnen Einfügepunkt und Lage der Blockinstanzen mit 1000 in Millimeter um, also Meter.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
FileNameLiest oder setzt die Datei, mit der die Blockdefinition verknüpft ist: eine Blockdatei (.sldblk) oder eine DXF- oder DWG-Datei.
InsertionPointLiest oder setzt den Einfügepunkt der Blockdefinition. Beim Lesen liefert die Eigenschaft immer den Ursprung (0, 0, 0).
LinkToFileLiest oder setzt, ob die Blockdefinition mit einer Datei verknüpft ist.

Methoden 26, davon 25 beschrieben, 1 veraltet

NameBeschreibung
GetArcCountLiefert die Zahl der Bögen in der Blockdefinition.
GetArcsLiefert die Daten aller Bögen der Blockdefinition in einem Zahlen-Array: Anfang, Ende, Mittelpunkt und Drehrichtung.
GetDisplayDimensionCountLiefert die Zahl der Bemaßungen in der Blockdefinition.
GetDisplayDimensionsLiefert die Bemaßungen der Blockdefinition.
GetEllipseCountLiefert die Zahl der Ellipsen in der Blockdefinition.
GetEllipsesLiefert die Daten aller Ellipsen der Blockdefinition in einem Zahlen-Array.
GetFeatureLiefert das Feature der Blockdefinition, etwa für ihren Namen.
GetInstanceCountLiefert, wie oft die Blockdefinition eingefügt ist, also die Zahl ihrer Blockinstanzen.
GetInstancesLiefert alle Blockinstanzen der Blockdefinition.
GetLineCountLiefert die Zahl der Linien in der Blockdefinition.
GetLinesLiefert die Daten aller Linien der Blockdefinition in einem Zahlen-Array.
GetNoteCountLiefert die Zahl der Notizen in der Blockdefinition.
GetNotesLiefert die Notizen der Blockdefinition.
GetParabolaCountLiefert die Zahl der Parabeln in der Blockdefinition.
GetParabolasLiefert die Daten aller Parabeln der Blockdefinition in einem Zahlen-Array.
GetSketchLiefert die Skizze, die den Block festlegt.
GetSplineCountLiefert die Zahl der Splines in der Blockdefinition und dazu eine Punktzahl.
GetSplineInterpolateCountLiefert die Zahl der Splines in der Blockdefinition und die Größe des Arrays für ihre Stützpunkte.
GetSplineParamsLiefert die Parameter aller Splines der Blockdefinition in einem Zahlen-Array mit gepackten Werten.
GetSplineParamsCountLiefert die Zahl der Splines in der Blockdefinition und die Größe des Arrays für ihre Parameter.
GetSplinesveraltet ersetzt durch SketchBlockDefinition.GetSplines2
GetSplines2Liefert Punkte auf allen Splines der Blockdefinition, angenähert nach der Darstellungsqualität.
GetSplinesInterpolateLiefert die Stützpunkte aller Splines der Blockdefinition, also die Punkte, aus denen sie erzeugt wurden.
GetUserPointsLiefert die Daten aller selbst gezeichneten Punkte der Blockdefinition in einem Zahlen-Array.
GetUserPointsCountLiefert die Zahl der selbst gezeichneten Punkte in der Blockdefinition.
SaveSpeichert die Blockdefinition in eine Blockdatei (.sldblk).

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

Siehe auch

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

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