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.
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
SketchManager.GetSketchBlockDefinitions: alle Blockdefinitionen eines DokumentsFeature.GetSpecificFeature2: aus dem Feature eines Blocks (TypnameSketchBlockDef)SketchBlockInstance.Definition: die Definition einer BlockinstanzSketchManager.MakeSketchBlockFromSelected,SketchManager.MakeSketchBlockFromSketchundSketchManager.MakeSketchBlockFromFile: eine neue Blockdefinition
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| FileName | Liest oder setzt die Datei, mit der die Blockdefinition verknüpft ist: eine Blockdatei (.sldblk) oder eine DXF- oder DWG-Datei. |
| InsertionPoint | Liest oder setzt den Einfügepunkt der Blockdefinition. Beim Lesen liefert die Eigenschaft immer den Ursprung (0, 0, 0). |
| LinkToFile | Liest oder setzt, ob die Blockdefinition mit einer Datei verknüpft ist. |
Methoden 26, davon 25 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| GetArcCount | Liefert die Zahl der Bögen in der Blockdefinition. |
| GetArcs | Liefert die Daten aller Bögen der Blockdefinition in einem Zahlen-Array: Anfang, Ende, Mittelpunkt und Drehrichtung. |
| GetDisplayDimensionCount | Liefert die Zahl der Bemaßungen in der Blockdefinition. |
| GetDisplayDimensions | Liefert die Bemaßungen der Blockdefinition. |
| GetEllipseCount | Liefert die Zahl der Ellipsen in der Blockdefinition. |
| GetEllipses | Liefert die Daten aller Ellipsen der Blockdefinition in einem Zahlen-Array. |
| GetFeature | Liefert das Feature der Blockdefinition, etwa für ihren Namen. |
| GetInstanceCount | Liefert, wie oft die Blockdefinition eingefügt ist, also die Zahl ihrer Blockinstanzen. |
| GetInstances | Liefert alle Blockinstanzen der Blockdefinition. |
| GetLineCount | Liefert die Zahl der Linien in der Blockdefinition. |
| GetLines | Liefert die Daten aller Linien der Blockdefinition in einem Zahlen-Array. |
| GetNoteCount | Liefert die Zahl der Notizen in der Blockdefinition. |
| GetNotes | Liefert die Notizen der Blockdefinition. |
| GetParabolaCount | Liefert die Zahl der Parabeln in der Blockdefinition. |
| GetParabolas | Liefert die Daten aller Parabeln der Blockdefinition in einem Zahlen-Array. |
| GetSketch | Liefert die Skizze, die den Block festlegt. |
| GetSplineCount | Liefert die Zahl der Splines in der Blockdefinition und dazu eine Punktzahl. |
| GetSplineInterpolateCount | Liefert die Zahl der Splines in der Blockdefinition und die Größe des Arrays für ihre Stützpunkte. |
| GetSplineParams | Liefert die Parameter aller Splines der Blockdefinition in einem Zahlen-Array mit gepackten Werten. |
| GetSplineParamsCount | Liefert die Zahl der Splines in der Blockdefinition und die Größe des Arrays für ihre Parameter. |
| GetSplines | veraltet ersetzt durch SketchBlockDefinition.GetSplines2 |
| GetSplines2 | Liefert Punkte auf allen Splines der Blockdefinition, angenähert nach der Darstellungsqualität. |
| GetSplinesInterpolate | Liefert die Stützpunkte aller Splines der Blockdefinition, also die Punkte, aus denen sie erzeugt wurden. |
| GetUserPoints | Liefert die Daten aller selbst gezeichneten Punkte der Blockdefinition in einem Zahlen-Array. |
| GetUserPointsCount | Liefert die Zahl der selbst gezeichneten Punkte in der Blockdefinition. |
| Save | Speichert 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.