Methode · View
InsertBreak3-Methode (View)
Fügt in die Zeichenansicht ein Paar Bruchlinien für eine waagrechte oder senkrechte Unterbrechung ein.
Syntax
Function InsertBreak3( _
ByVal Orientation As Long, _
ByVal Position1 As Double, _
ByVal Position2 As Double, _
ByVal Style As Long, _
ByVal ShapeIntensity As Long, _
ByVal BreakSketchBlocks As Boolean _
) As ObjectSet swBreak = swView.InsertBreak3(swBreakLineVertical, -0.02, 0.02, swBreakLine_ZigZag, 1, False)Parameter
OrientationLongByVal- Richtung des Schnitts als
swBreakLineOrientation_e:swBreakLineHorizontal(1): waagrecht,swBreakLineVertical(2): senkrecht. Position1DoubleByVal- Lage der ersten Bruchlinie, gemessen vom Ursprung der Zeichenansicht. Bei waagrechtem Bruch ist es ein Y-Wert, bei senkrechtem ein X-Wert. Die Hilfe nennt keine Einheit, vermutlich Meter.
Position2DoubleByVal- Lage der zweiten Bruchlinie, sonst wie Position1.
StyleLongByValForm der Bruchlinien als
swBreakLineStyle_e:swBreakLine_Straight(1): gerade SchnittlinieswBreakLine_ZigZag(2): Zickzack-SchnittswBreakLine_Curve(3): KurvenschnittswBreakLine_SmallZigZag(4): kleiner Zickzack-SchnittswBreakLine_Jagged(5): gezackter Schnitt
ShapeIntensityLongByVal- Stärke der Zacken, nur bei
swBreakLine_Jagged: 1 (am stärksten) bis 5 (am schwächsten). BreakSketchBlocksBooleanByValTrueunterbricht auch Skizzenblöcke,Falsenicht.
Rückgabewert
Die Bruchlinie (BreakLine). Sie steht für das ganze Paar: BreakLine.GetPosition liefert mit Index 0 und 1 die Lage beider Linien. Was bei einem Fehler zurückkommt, sagt die Hilfe nicht. Prüf das Ergebnis mit Is Nothing.
Beispiel
' swView ist eine Zeichenansicht (View), etwa aus DrawingDoc.ActiveDrawingView oder der Auswahl.
Dim swBreak As SldWorks.BreakLine
' 20 mm links und rechts vom Ursprung der Ansicht (Einheit vermutlich Meter)
Set swBreak = swView.InsertBreak3(swBreakLineVertical, -0.02, 0.02, swBreakLine_Jagged, 3, False)
If swBreak Is Nothing Then
Debug.Print "Keine Bruchlinien eingefügt."
Else
Debug.Print "Bruchlinien bei " & swBreak.GetPosition(0) * 1000 & " und " & swBreak.GetPosition(1) * 1000 & " mm"
Debug.Print "Ansicht unterbrochen dargestellt: " & swView.IsBroken
End IfBemerkungen
Eine Unterbrechung besteht aus zwei Bruchlinien, zwischen denen die Ansicht ausgespart wird. Bei waagrechtem Bruch sind Position1 und Position2 Y-Werte, bei senkrechtem X-Werte, jeweils bezogen auf den Ursprung der Zeichenansicht.
Ob die Ansicht vorher aktiviert oder ausgewählt sein muss und ob sie nach dem Aufruf schon unterbrochen dargestellt wird, sagt die Hilfe nicht. Im Zweifel aktivierst du sie mit DrawingDoc.ActivateView und wählst sie aus. View.IsBroken zeigt, ob die Ansicht unterbrochen dargestellt wird (nicht, ob sie Bruchlinien hat). DrawingDoc.BreakView unterbricht eine Ansicht entlang ihrer vorhandenen Bruchlinien. Die Breite der Lücke an der Bruchlinie regelt View.BreakLineGap, vorhandene Bruchlinien liefern View.GetBreakLineCount2, View.GetBreakLineInfo2 und View.GetBreakLines.
Ersetzt View.InsertBreak2, neu ist der Parameter BreakSketchBlocks.
Nach dem Aufruf sind die Bruchlinien da, die Ansicht wird aber noch nicht unterbrochen dargestellt: View.IsBroken liefert False.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2018
Englisches Original: IView::InsertBreak3 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.