SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchBlockInstance-Objekt

Eine Blockinstanz: ein eingefügter Block mit Lage, Winkel, Maßstab, Attributen und Bezugslinie.

Deklaration Dim x As SldWorks.SketchBlockInstance · in der englischen .NET-Hilfe: ISketchBlockInstance

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

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 Sub

Bemerkungen

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

NameBeschreibung
AngleLiest oder setzt den Winkel, um den die Blockinstanz um ihren Einfügepunkt gedreht ist, im Bogenmaß.
BlockToSketchTransformLiefert die Transformation von den Koordinaten des Blocks in die Koordinaten der Skizze, in der die Blockinstanz steckt.
DefinitionLiest oder setzt die Blockdefinition der Blockinstanz.
DimensionDisplayLiefert, ob die Bemaßungen der Blockinstanz angezeigt werden.
InstancePositionLiest oder setzt die Lage der Blockinstanz in ihrer Skizze.
LayerLiest oder setzt den Layer, auf dem die Blockinstanz liegt.
LockAngleLiest oder setzt, ob der Drehwinkel der Blockinstanz gesperrt ist.
NameLiest oder setzt den Namen der Blockinstanz.
Scaleveraltet ersetzt durch SketchBlockInstance.Scale2
Scale2Setzt den Maßstab der Blockinstanz. Zum Lesen nimmst du GetScale3.
TextDisplayLiest oder setzt, wie die Texte der Blockinstanz angezeigt werden.
VisibleLiest oder setzt, ob die Blockinstanz sichtbar oder ausgeblendet ist.

Methoden 13, davon 13 beschrieben

NameBeschreibung
GetArrowHeadStyleLiefert die Pfeilspitze der Bezugslinie der Blockinstanz.
GetAttachedEntitiesLiefert die Elemente, an denen die Blockinstanz hängt, etwa über ihre Bezugslinie.
GetAttributeCountLiefert die Zahl der Attribute der Blockinstanz.
GetAttributesLiefert die Attribute der Blockinstanz, also ihre Notizen mit Tag-Namen.
GetAttributeValueLiefert den Wert eines Attributs der Blockinstanz über seinen Tag-Namen.
GetLeaderPointsLiefert die Punkte der Bezugslinie der Blockinstanz.
GetLeaderStyleLiefert die Art der Bezugslinie der Blockinstanz: keine, gerade oder geknickt.
GetScale3Liefert den Maßstab der Blockinstanz, wahlweise ohne den Maßstab des übergeordneten Elements.
GetSketchLiefert die Skizze, in der die Blockinstanz steckt.
IsNestedLiefert, ob die Blockinstanz in einer anderen Blockdefinition steckt.
SelectWählt die Blockinstanz aus.
SetAttributeValueSetzt den Wert eines Attributs der Blockinstanz über seinen Tag-Namen.
SetLeaderSetzt 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.