SolidWorksMakroprogrammierung

Objekt · SldWorks

BreakLine-Objekt

Eine Unterbrechung in einer Zeichenansicht: ein Paar Bruchlinien mit Lage, Richtung, Form und Layer.

Deklaration Dim x As SldWorks.BreakLine · in der englischen .NET-Hilfe: IBreakLine

Beschreibung

BreakLine gibt Zugriff auf eine Unterbrechung in einer Zeichenansicht. Sie besteht aus einem Paar Bruchlinien, zwischen denen die Ansicht ausgespart wird. Eine Ansicht kann mehrere Unterbrechungen haben.

Zugriff

Beispiel

' Gibt für jede Unterbrechung der ausgewählten Zeichenansicht Richtung, Lage und Form aus
' und unterbricht die Ansicht danach.
' Vorbedingung: Eine Zeichnung ist offen, eine Zeichenansicht mit eingefügten Unterbrechungen ist ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, die Ansicht ist unterbrochen.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swView As SldWorks.View
    Dim swBruch As SldWorks.BreakLine
    Dim vBrueche As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub
    Set swDraw = swModel
    Set swView = swModel.SelectionManager.GetSelectedObjectsDrawingView2(1, -1)
    If swView Is Nothing Then Exit Sub

    vBrueche = swView.GetBreakLines
    If Not IsArray(vBrueche) Then Exit Sub
    For i = 0 To UBound(vBrueche)
        Set swBruch = vBrueche(i)
        Debug.Print "Unterbrechung " & i + 1 & ": " & IIf(swBruch.Orientation = swBreakLineHorizontal, "waagrecht", "senkrecht") & _
                    " bei " & swBruch.GetPosition(0) * 1000 & " und " & swBruch.GetPosition(1) * 1000 & " mm, Form " & swBruch.Style
    Next i

    swDraw.BreakView                                 ' wirkt auf die ausgewählte Ansicht
End Sub

Bemerkungen

Einfügen und anwenden: Eine Unterbrechung fügst du mit View.InsertBreak3 ein. Unterbrochen wird die Ansicht erst mit DrawingDoc.BreakView, aufgehoben mit DrawingDoc.UnBreakView. So geht auch das Hilfebeispiel „Create Break View“ vor, das die Ansicht dafür auswählt. Ob eine Ansicht unterbrochen ist, liefert View.IsBroken.

Lage: BreakLine.GetPosition liefert bei waagrechten Bruchlinien einen Y-Wert, bei senkrechten einen X-Wert, bezogen auf die Mitte der Zeichenansicht. Nach BreakLine.SetPosition baust du mit ModelDoc2.EditRebuild3 neu auf.

Gezackte Bruchlinien: Die Stärke der Zacken (BreakLine.ShapeIntensity) gilt nur bei der Form swBreakLine_Jagged.

Die Lagen der Bruchlinien sind Meter auf dem Zeichenblatt, nicht im Modell. Der Maßstab der Ansicht ändert daran nichts.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
BreakSketchBlocksLiest oder setzt, ob die Unterbrechung auch Blöcke in der Skizze der Zeichenansicht unterbricht.
LayerLiest oder setzt den Layer, auf dem die Bruchlinien der Unterbrechung liegen.
OrientationLiefert, ob die Bruchlinien der Unterbrechung waagrecht oder senkrecht liegen.
ShapeIntensityLiest oder setzt, wie stark eine gezackte Bruchlinie gezackt ist, von 1 (am stärksten) bis 5 (am schwächsten).
StyleLiest oder setzt die Form der Bruchlinien, etwa gerade, Zickzack, Kurve oder gezackt.

Methoden 4, davon 4 beschrieben

NameBeschreibung
GetPositionLiefert die Lage einer der beiden Bruchlinien in der Zeichenansicht.
GetViewLiefert die Zeichenansicht, zu der die Unterbrechung gehört.
SelectWählt die Unterbrechung aus und markiert sie.
SetPositionSetzt die Lage der beiden Bruchlinien in der Zeichenansicht.

Siehe auch

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

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