Objekt · SldWorks
DrSection-Objekt
Die Schnittlinie einer Schnittansicht in einer Zeichnung: Bezeichnung, Lage von Linie, Pfeilen und Texten, Schnittrichtung, Schnitttiefe, Schraffur und ausgeschlossene Komponenten.
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
View.GetSection: aus einer Schnittansicht ihre Schnittlinie, so in allen HilfebeispielenView.GetSectionLines: aus einer Ausgangsansicht alle ihre Schnittlinien als Array, die Anzahl mitView.GetSectionLineCount2View.EnumSectionLines2: dasselbe als Aufzählung EnumDrSections, nur für In-Process-DLLsFeature.GetSpecificFeature2: aus dem Feature einer Schnittlinie, wennFeature.GetTypeName2DrSectionLineliefert. BeiDrBreakoutSectionLinesteht ein DrSection oder einBrokenOutSectionFeatureDatadahinter.SelectionMgr.GetSelectedObject6: bei einer ausgewählten Schnittlinie (swSelSECTIONLINESausswSelectType_e, Typname „SECTIONLINE“) einFeature, daraus mitFeature.GetSpecificFeature2der DrSection
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| CutSurfaceBodies | Liest oder setzt, ob die Schnittansicht geschnittene Flächenkörper ausblendet. |
| CuttingLineShoulders | Liest oder setzt, ob die Schultern der Schnittlinie ausgeblendet sind. |
| DisplaySurfaceBodies | Liest oder setzt, ob die Schnittansicht Flächenkörper zeigt. |
| ExcludeFasteners | Liest oder setzt, ob die Schnittansicht Verbindungselemente ausschließt. |
| ExcludeSliceSectionBodies | Liest oder setzt, ob die Schnittansicht die Körper eines Scheibenschnitts ausschließt. |
| Layer | Liest oder setzt den Namen des Layers, auf dem die Schnittlinie liegt. |
| RandomizeScale | Liest oder setzt, ob die automatische Schraffur der Schnittansicht mit zufälliger Skalierung arbeitet. |
| ScaleHatchPattern | Liest oder setzt, ob das Schraffurmuster mit der Schnittansicht skaliert wird. |
| SectionDepth | Liest oder setzt die Schnitttiefe, also den Abstand von der Schnittlinie, bis zu dem die Schnittansicht reicht. |
Methoden 32, davon 30 beschrieben, 2 veraltet
| Name | Beschreibung |
|---|---|
| EnumExcludedComponents | veraltet ersetzt durch DrSection.EnumExcludedComponents2 |
| EnumExcludedComponents2 | Liefert die Komponenten, die von der Schnittansicht ausgeschlossen sind, als Aufzählung. |
| GetArrowInfo | Liefert Anfang und Ende der beiden Pfeile an den Enden der Schnittlinie. |
| GetAutoHatch | Liefert, ob die automatische Schraffur für die Schnittansicht eingeschaltet ist. |
| GetDisplayOnlySpeedPakBodies | Liefert, ob die Schnittansicht nur die Körper aus der SpeedPak-Konfiguration zeigt. |
| GetDisplayOnlySurfaceCut | Liefert, ob die Schnittansicht nur die Schnittfläche zeigt, die die Schnittlinie erzeugt. |
| GetDontCutAllInstances | Liefert, ob alle Instanzen einer Komponente in der Schnittansicht ungeschnitten bleiben oder nur diese eine Komponente. |
| GetExcludedComponents | Liefert die Komponenten, die von der Schnittansicht ausgeschlossen sind, also nicht geschnitten werden. |
| GetLabel | Liefert die Bezeichnung der Schnittansicht, etwa „A“. |
| GetLineInfo | Liefert die Eckpunkte der Schnittlinie, je Abschnitt Anfangs- und Endpunkt. |
| GetName | Liefert den Namen der Schnittlinie. |
| GetPartialSection | Liefert, ob die Schnittansicht ein Teilschnitt ist. |
| GetReversedCutDirection | Liefert, ob die Schnittrichtung gegenüber der Vorgabe umgekehrt ist. |
| GetScaleWithModelChanges | Liefert, ob die Schnittlinie mit Änderungen am Modell skaliert wird. |
| GetSectionView | Liefert die Schnittansicht, die aus dieser Schnittlinie entsteht. |
| GetTextFormat | Liefert das Textformat der Texte an der Schnittlinie. |
| GetTextInfo | Liefert die Lage der beiden Texte an den Enden der Schnittlinie. |
| GetUseDocTextFormat | Liefert, ob die Texte an der Schnittlinie das Standard-Textformat des Dokuments verwenden. |
| GetView | Liefert die Zeichenansicht, in der die Schnittlinie liegt. |
| IsAligned | Liefert, ob die Schnittansicht eine ausgerichtete Schnittansicht ist. |
| SetAutoHatch | Schaltet die automatische Schraffur für die Schnittansicht ein oder aus. |
| SetDisplayOnlySpeedPakBodies | Legt fest, ob die Schnittansicht nur die Körper aus der SpeedPak-Konfiguration zeigt. |
| SetDisplayOnlySurfaceCut | Legt fest, ob die Schnittansicht nur die Schnittfläche zeigt, die die Schnittlinie erzeugt. |
| SetDontCutAllInstances | Legt fest, ob alle Instanzen einer Komponente in der Schnittansicht ungeschnitten bleiben oder nur diese eine Komponente. |
| SetExcludedComponents | Schließt Komponenten von der Schnittansicht aus, sie werden dann nicht geschnitten. |
| SetLabel | veraltet ersetzt durch DrSection.SetLabel2 |
| SetLabel2 | Setzt die Bezeichnung der Schnittansicht, etwa „B“, und meldet, ob sie schon vergeben ist. |
| SetLineInfo | Setzt die Lage der Schnittlinie mit ihren Pfeilen über die Eckpunkte ihrer Abschnitte. |
| SetPartialSection | Legt fest, ob die Schnittansicht ein Teilschnitt ist. |
| SetReversedCutDirection | Kehrt die Schnittrichtung gegenüber der Vorgabe um oder setzt sie zurück. |
| SetScaleWithModelChanges | Legt fest, ob die Schnittlinie mit Änderungen am Modell skaliert wird. |
| SetTextFormat | Setzt 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.