SolidWorksMakroprogrammierung

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 Object
Set 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.
StyleLongByVal

Form der Bruchlinien als swBreakLineStyle_e:

  • swBreakLine_Straight (1): gerade Schnittlinie
  • swBreakLine_ZigZag (2): Zickzack-Schnitt
  • swBreakLine_Curve (3): Kurvenschnitt
  • swBreakLine_SmallZigZag (4): kleiner Zickzack-Schnitt
  • swBreakLine_Jagged (5): gezackter Schnitt
ShapeIntensityLongByVal
Stärke der Zacken, nur bei swBreakLine_Jagged: 1 (am stärksten) bis 5 (am schwächsten).
BreakSketchBlocksBooleanByVal
True unterbricht auch Skizzenblöcke, False nicht.

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 If

Bemerkungen

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.