Objekt · SldWorks
SketchBlockInstance-Objekt
Eine Blockinstanz: ein eingefügter Block mit Lage, Winkel, Maßstab, Attributen und Bezugslinie.
Beschreibung
SketchBlockInstance gibt Zugriff auf eine Blockinstanz, also einen eingefügten Block. Den Inhalt des Blocks legt seine Blockdefinition (SketchBlockDefinition) fest. Jede Blockinstanz hat ihre eigene Lage, ihren Winkel und Maßstab und eigene Werte für die Attribute. Seit SOLIDWORKS 2007 ersetzt das Objekt die veraltete BlockInstance.
Zugriff
SketchBlockDefinition.GetInstances: alle Blockinstanzen einer BlockdefinitionSketch.GetSketchBlockInstances: die Blockinstanzen einer SkizzeSketchManager.InsertSketchBlockInstance: eine neue BlockinstanzLayer.GetItems: die Elemente eines Layers, darunter BlockinstanzenSelectionMgr.GetSelectedObject6: eine ausgewählte Blockinstanz (AuswahltypswSelSUBSKETCHINST)
Beispiel
' Gibt für jede Blockinstanz des aktiven Dokuments Name, Lage, Winkel, Maßstab und Attribute aus.
' 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 vAttribute As Variant
Dim vLage 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
If IsArray(vInstanzen) Then
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"
Debug.Print " Winkel: " & Format(swBlockInst.Angle * 57.2957795, "0.0") & " Grad"
Debug.Print " Maßstab: " & swBlockInst.GetScale3(False) ' vor SOLIDWORKS 2024 SP01: Scale2
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
Attribute: Attribute sind Notizen mit Tag-Namen, die nicht schreibgeschützt sind. Sie gehören zur Blockdefinition, ihren Wert hat aber jede Blockinstanz für sich. Du liest und setzt ihn mit SketchBlockInstance.GetAttributeValue und SketchBlockInstance.SetAttributeValue über den Tag-Namen.
Winkel ändern: SketchBlockInstance.Angle änderst du nur, während du die Skizze des Blocks bearbeitest. Das Hilfebeispiel ruft dafür vorher ModelDoc2.EditSketch auf.
Maßstab: Gesetzt wird er mit SketchBlockInstance.Scale2, gelesen seit SOLIDWORKS 2024 SP01 mit SketchBlockInstance.GetScale3. Das Lesen über Scale2 ist veraltet.
Bezugslinie: Eine Blockinstanz kann mit einer Bezugslinie an Flächen, Kanten, Eckpunkten oder Skizzenelementen hängen. Sie bleibt daran hängen, auch wenn die Bezugslinie ausgeblendet ist.
Koordinaten: Lage und Punkte der Bezugslinie liegen in der Skizze, in der die Blockinstanz steckt. Punkte aus der Blockdefinition rechnest du mit SketchBlockInstance.BlockToSketchTransform dorthin um. Die Hilfebeispiele rechnen Längen mit 1000 in Millimeter um, also Meter.
Zeichnungen: Blockinstanzen im Blattformat einer Zeichnung erreichst du, indem du das Blattformat mit DrawingDoc.EditTemplate bearbeitest und dann die aktive Skizze holst (SketchManager.ActiveSketch). Deren Blockinstanzen liefert Sketch.GetSketchBlockInstances.
Eigenschaften und Methoden
Eigenschaften 12, davon 11 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Winkel, um den die Blockinstanz um ihren Einfügepunkt gedreht ist, im Bogenmaß. |
| BlockToSketchTransform | Liefert die Transformation von den Koordinaten des Blocks in die Koordinaten der Skizze, in der die Blockinstanz steckt. |
| Definition | Liest oder setzt die Blockdefinition der Blockinstanz. |
| DimensionDisplay | Liefert, ob die Bemaßungen der Blockinstanz angezeigt werden. |
| InstancePosition | Liest oder setzt die Lage der Blockinstanz in ihrer Skizze. |
| Layer | Liest oder setzt den Layer, auf dem die Blockinstanz liegt. |
| LockAngle | Liest oder setzt, ob der Drehwinkel der Blockinstanz gesperrt ist. |
| Name | Liest oder setzt den Namen der Blockinstanz. |
| Scale | veraltet ersetzt durch SketchBlockInstance.Scale2 |
| Scale2 | Setzt den Maßstab der Blockinstanz. Zum Lesen nimmst du GetScale3. |
| TextDisplay | Liest oder setzt, wie die Texte der Blockinstanz angezeigt werden. |
| Visible | Liest oder setzt, ob die Blockinstanz sichtbar oder ausgeblendet ist. |
Methoden 13, davon 13 beschrieben
| Name | Beschreibung |
|---|---|
| GetArrowHeadStyle | Liefert die Pfeilspitze der Bezugslinie der Blockinstanz. |
| GetAttachedEntities | Liefert die Elemente, an denen die Blockinstanz hängt, etwa über ihre Bezugslinie. |
| GetAttributeCount | Liefert die Zahl der Attribute der Blockinstanz. |
| GetAttributes | Liefert die Attribute der Blockinstanz, also ihre Notizen mit Tag-Namen. |
| GetAttributeValue | Liefert den Wert eines Attributs der Blockinstanz über seinen Tag-Namen. |
| GetLeaderPoints | Liefert die Punkte der Bezugslinie der Blockinstanz. |
| GetLeaderStyle | Liefert die Art der Bezugslinie der Blockinstanz: keine, gerade oder geknickt. |
| GetScale3 | Liefert den Maßstab der Blockinstanz, wahlweise ohne den Maßstab des übergeordneten Elements. |
| GetSketch | Liefert die Skizze, in der die Blockinstanz steckt. |
| IsNested | Liefert, ob die Blockinstanz in einer anderen Blockdefinition steckt. |
| Select | Wählt die Blockinstanz aus. |
| SetAttributeValue | Setzt den Wert eines Attributs der Blockinstanz über seinen Tag-Namen. |
| SetLeader | Setzt die Art der Bezugslinie und die Pfeilspitze der Blockinstanz. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetAttributes). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ISketchBlockInstance in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.