SolidWorksMakroprogrammierung

Objekt · SldWorks

DrSection-Objekt

Die Schnittlinie einer Schnittansicht in einer Zeichnung: Bezeichnung, Lage von Linie, Pfeilen und Texten, Schnittrichtung, Schnitttiefe, Schraffur und ausgeschlossene Komponenten.

Deklaration Dim x As SldWorks.DrSection · in der englischen .NET-Hilfe: IDrSection

Beschreibung

DrSection gibt Zugriff auf eine Schnittansicht in einer Zeichnung. Die meisten Befehle beziehen sich auf die Schnittlinie: Sie liegt in der Ausgangsansicht, hat an jedem Ende einen Pfeil und meist einen Text mit der Bezeichnung, etwa „A“. Aus ihr entsteht die Schnittansicht. Über DrSection liest und änderst du die Lage der Schnittlinie, ihre Bezeichnung und die Einstellungen der Schnittansicht. Die meisten Befehle gibt es seit SOLIDWORKS 2000, die jüngsten seit SOLIDWORKS 2018. Für DrSection.Layer und DrSection.SetLineInfo nennt die Hilfe keine Version.

Zugriff

Neu angelegt wird eine Schnittansicht mit DrawingDoc.CreateSectionViewAt5, danach holst du mit View.GetSection ihren DrSection.

Beispiel

' Gibt für jede Schnittlinie in den Ansichten des aktuellen Blatts Bezeichnung,
' Schnittansicht, Art, Schnitttiefe und die Lage von Linie, Pfeilen und Texten aus.
' Vorbedingung: Eine Zeichnung mit mindestens einer Schnittansicht ist offen.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G).
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 swSchnitt As SldWorks.DrSection
    Dim swSchnittAnsicht As SldWorks.View
    Dim vLinien As Variant
    Dim vLinie As Variant
    Dim vPfeile As Variant
    Dim vText As Variant
    Dim lGroesse As Long
    Dim i As Long
    Dim j 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

    ' Die erste Ansicht ist das Blatt selbst, die Zeichenansichten folgen.
    Set swView = swDraw.GetFirstView
    Set swView = swView.GetNextView
    Do While Not swView Is Nothing
        If swView.GetSectionLineCount2(lGroesse) > 0 Then
            vLinien = swView.GetSectionLines
            For i = 0 To UBound(vLinien)
                Set swSchnitt = vLinien(i)
                Set swSchnittAnsicht = swSchnitt.GetSectionView
                Debug.Print "Schnitt " & swSchnitt.GetLabel & " (" & swSchnitt.GetName & ") in " & swView.GetName2
                If Not swSchnittAnsicht Is Nothing Then
                    Debug.Print "  Schnittansicht:   " & swSchnittAnsicht.GetName2
                End If
                Debug.Print "  Ausgerichtet:     " & swSchnitt.IsAligned
                Debug.Print "  Teilschnitt:      " & swSchnitt.GetPartialSection
                Debug.Print "  Richtung umgek.:  " & swSchnitt.GetReversedCutDirection
                Debug.Print "  Schnitttiefe:     " & swSchnitt.SectionDepth * 1000# & " mm"
                Debug.Print "  Autom. Schraffur: " & swSchnitt.GetAutoHatch
                Debug.Print "  Layer:            " & swSchnitt.Layer

                ' Je Abschnitt 6 Werte: x, y, z Anfang und x, y, z Ende
                vLinie = swSchnitt.GetLineInfo
                For j = 0 To UBound(vLinie) Step 6
                    Debug.Print "  Abschnitt (mm):   " & vLinie(j) * 1000# & ", " & vLinie(j + 1) * 1000# & _
                                " -> " & vLinie(j + 3) * 1000# & ", " & vLinie(j + 4) * 1000#
                Next j
                vPfeile = swSchnitt.GetArrowInfo
                Debug.Print "  Pfeil 1 ab (mm):  " & vPfeile(0) * 1000# & ", " & vPfeile(1) * 1000#
                Debug.Print "  Pfeil 2 ab (mm):  " & vPfeile(6) * 1000# & ", " & vPfeile(7) * 1000#
                vText = swSchnitt.GetTextInfo
                Debug.Print "  Text 1 (mm):      " & vText(0) * 1000# & ", " & vText(1) * 1000#
                Debug.Print "  Text 2 (mm):      " & vText(3) * 1000# & ", " & vText(4) * 1000#
            Next i
        End If
        Set swView = swView.GetNextView
    Loop
End Sub

Bemerkungen

Hilfebeispiele: „Create Section View and Get Some Data“ zeichnet in einer Ansicht eine Linie, legt mit DrawingDoc.CreateSectionViewAt5 eine Schnittansicht an, holt mit View.GetSection den DrSection, setzt automatische Schraffur, Bezeichnung „ABCD“, Teilschnitt, Schnittrichtung, Skalieren und die Körper-Einstellungen, liest alles zurück und baut mit ModelDoc2.EditRebuild3 neu auf. „Get and Set Whether to Hide Cutting Line Shoulders“ legt eine Schnittansicht mit zwei Linien an und schaltet DrSection.CuttingLineShoulders um. „Scale Hatch Pattern to Section View“ aktiviert eine vorhandene Schnittansicht und setzt DrSection.ScaleHatchPattern.

Zwei Richtungen: View.GetSection rufst du an der Schnittansicht auf, View.GetSectionLines an der Ansicht, in der die Schnittlinien liegen. Vom DrSection aus kommst du mit DrSection.GetView und DrSection.GetSectionView zu beiden Ansichten zurück.

Neu aufbauen: Nach DrSection.SetLineInfo, DrSection.SetReversedCutDirection und DrSection.ExcludeFasteners rufst du ModelDoc2.EditRebuild3 auf, nach DrSection.SetAutoHatch baust du die Schnittansicht neu auf. Bei den übrigen Befehlen sagt die Hilfe dazu nichts.

Einstellungen des Dokuments: Linienart der Schnittlinie sowie Größe und Art der Pfeile sind Einstellungen des Dokuments, nicht der einzelnen Schnittlinie. Sie stehen nicht in den Arrays von DrSection.GetLineInfo und DrSection.GetArrowInfo, sondern in swLineFontSectionLineStyle (swUserPreferenceIntegerValue_e) und swDetailingSectionArrowHeight, swDetailingSectionArrowWidth und swDetailingSectionArrowLength (swUserPreferenceDoubleValue_e). Alles zusammen samt Layer liefert View.GetSectionLineInfo2 für alle Schnittlinien einer Ansicht.

Nur Baugruppen: Automatische Schraffur und ausgeschlossene Komponenten gibt es nur bei Schnittansichten von Baugruppen.

Einheiten: Für DrSection.SectionDepth rechnet das Hilfebeispiel mit dem Faktor 1000 in mm um, es sind also Meter. Für die Punkte aus DrSection.GetLineInfo, DrSection.GetArrowInfo und DrSection.GetTextInfo nennt die Hilfe weder Einheit noch Koordinatensystem, vermutlich Meter auf dem Blatt.

Veraltet: EnumExcludedComponents und SetLabel sind veraltet. Ihre Nachfolger sind DrSection.EnumExcludedComponents2 und DrSection.SetLabel2.

Die Punkte aus DrSection.GetArrowInfo und DrSection.GetTextInfo liegen in Metern in Blattkoordinaten, die Punkte aus DrSection.GetLineInfo dagegen in Metern in den Koordinaten der Ansicht.

Eigenschaften und Methoden

Eigenschaften 9, davon 9 beschrieben

NameBeschreibung
CutSurfaceBodiesLiest oder setzt, ob die Schnittansicht geschnittene Flächenkörper ausblendet.
CuttingLineShouldersLiest oder setzt, ob die Schultern der Schnittlinie ausgeblendet sind.
DisplaySurfaceBodiesLiest oder setzt, ob die Schnittansicht Flächenkörper zeigt.
ExcludeFastenersLiest oder setzt, ob die Schnittansicht Verbindungselemente ausschließt.
ExcludeSliceSectionBodiesLiest oder setzt, ob die Schnittansicht die Körper eines Scheibenschnitts ausschließt.
LayerLiest oder setzt den Namen des Layers, auf dem die Schnittlinie liegt.
RandomizeScaleLiest oder setzt, ob die automatische Schraffur der Schnittansicht mit zufälliger Skalierung arbeitet.
ScaleHatchPatternLiest oder setzt, ob das Schraffurmuster mit der Schnittansicht skaliert wird.
SectionDepthLiest oder setzt die Schnitttiefe, also den Abstand von der Schnittlinie, bis zu dem die Schnittansicht reicht.

Methoden 32, davon 30 beschrieben, 2 veraltet

NameBeschreibung
EnumExcludedComponentsveraltet ersetzt durch DrSection.EnumExcludedComponents2
EnumExcludedComponents2Liefert die Komponenten, die von der Schnittansicht ausgeschlossen sind, als Aufzählung.
GetArrowInfoLiefert Anfang und Ende der beiden Pfeile an den Enden der Schnittlinie.
GetAutoHatchLiefert, ob die automatische Schraffur für die Schnittansicht eingeschaltet ist.
GetDisplayOnlySpeedPakBodiesLiefert, ob die Schnittansicht nur die Körper aus der SpeedPak-Konfiguration zeigt.
GetDisplayOnlySurfaceCutLiefert, ob die Schnittansicht nur die Schnittfläche zeigt, die die Schnittlinie erzeugt.
GetDontCutAllInstancesLiefert, ob alle Instanzen einer Komponente in der Schnittansicht ungeschnitten bleiben oder nur diese eine Komponente.
GetExcludedComponentsLiefert die Komponenten, die von der Schnittansicht ausgeschlossen sind, also nicht geschnitten werden.
GetLabelLiefert die Bezeichnung der Schnittansicht, etwa „A“.
GetLineInfoLiefert die Eckpunkte der Schnittlinie, je Abschnitt Anfangs- und Endpunkt.
GetNameLiefert den Namen der Schnittlinie.
GetPartialSectionLiefert, ob die Schnittansicht ein Teilschnitt ist.
GetReversedCutDirectionLiefert, ob die Schnittrichtung gegenüber der Vorgabe umgekehrt ist.
GetScaleWithModelChangesLiefert, ob die Schnittlinie mit Änderungen am Modell skaliert wird.
GetSectionViewLiefert die Schnittansicht, die aus dieser Schnittlinie entsteht.
GetTextFormatLiefert das Textformat der Texte an der Schnittlinie.
GetTextInfoLiefert die Lage der beiden Texte an den Enden der Schnittlinie.
GetUseDocTextFormatLiefert, ob die Texte an der Schnittlinie das Standard-Textformat des Dokuments verwenden.
GetViewLiefert die Zeichenansicht, in der die Schnittlinie liegt.
IsAlignedLiefert, ob die Schnittansicht eine ausgerichtete Schnittansicht ist.
SetAutoHatchSchaltet die automatische Schraffur für die Schnittansicht ein oder aus.
SetDisplayOnlySpeedPakBodiesLegt fest, ob die Schnittansicht nur die Körper aus der SpeedPak-Konfiguration zeigt.
SetDisplayOnlySurfaceCutLegt fest, ob die Schnittansicht nur die Schnittfläche zeigt, die die Schnittlinie erzeugt.
SetDontCutAllInstancesLegt fest, ob alle Instanzen einer Komponente in der Schnittansicht ungeschnitten bleiben oder nur diese eine Komponente.
SetExcludedComponentsSchließt Komponenten von der Schnittansicht aus, sie werden dann nicht geschnitten.
SetLabelveraltet ersetzt durch DrSection.SetLabel2
SetLabel2Setzt die Bezeichnung der Schnittansicht, etwa „B“, und meldet, ob sie schon vergeben ist.
SetLineInfoSetzt die Lage der Schnittlinie mit ihren Pfeilen über die Eckpunkte ihrer Abschnitte.
SetPartialSectionLegt fest, ob die Schnittansicht ein Teilschnitt ist.
SetReversedCutDirectionKehrt die Schnittrichtung gegenüber der Vorgabe um oder setzt sie zurück.
SetScaleWithModelChangesLegt fest, ob die Schnittlinie mit Änderungen am Modell skaliert wird.
SetTextFormatSetzt das Textformat der Texte an der Schnittlinie oder stellt auf das Format des Dokuments um.

Nicht aufgeführt sind 10 C++-Varianten (Namen mit I davor, zum Beispiel IGetArrowInfo). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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