SolidWorksMakroprogrammierung

Objekt · SldWorks

SectionViewData-Objekt

Die Daten einer Schnittansicht im Teil oder in der Baugruppe: bis zu drei Schnittebenen mit Abstand, Drehung und Farbe, dazu Schnittflächen sowie zonale, selektive und transparente Schnitte.

Deklaration Dim x As SldWorks.SectionViewData · in der englischen .NET-Hilfe: ISectionViewData

Beschreibung

Mit SectionViewData legst du Schnittansichten in Teilen und Baugruppen an und liest sie aus. Eine Schnittansicht hat bis zu drei Schnitte. Jeder Schnitt hat eine Ebene oder ebene Fläche, einen Abstand, eine Drehung um x und y, eine Richtung und eine Farbe. Die Befehle für die drei Schnitte gibt es seit SOLIDWORKS 2007, die für zonale, selektive und transparente Schnitte seit SOLIDWORKS 2017.

Zugriff

Den ModelViewManager bekommst du aus ModelDoc2.ModelViewManager.

Beispiel

' Legt im offenen Teil eine Schnittansicht mit den Ebenen Front und Top an,
' beide farbig gedeckelt, und gibt danach ihre Daten aus.
' Vorbedingung: Ein Teil mit den Ebenen "Front" und "Top" ist offen (englische Vorlage).
' Ergebnis:     Die Schnittansicht ist im Grafikbereich zu sehen, die Werte stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swEbene1 As SldWorks.Feature
    Dim swEbene2 As SldWorks.Feature
    Dim swDaten As SldWorks.SectionViewData
    Dim bOk As Boolean

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager

    swModel.ClearSelection2 True
    bOk = swModel.Extension.SelectByID2("Front", "PLANE", 0, 0, 0, False, 1, Nothing, 0)
    bOk = swModel.Extension.SelectByID2("Top", "PLANE", 0, 0, 0, True, 2, Nothing, 0)
    Set swEbene1 = swSelMgr.GetSelectedObject6(1, -1)
    Set swEbene2 = swSelMgr.GetSelectedObject6(2, -1)

    Set swDaten = swModel.ModelViewManager.CreateSectionViewData()
    swDaten.FirstPlane = swEbene1
    swDaten.FirstOffset = 0.005                 ' Meter
    swDaten.FirstColor = RGB(255, 0, 0)
    swDaten.SecondPlane = swEbene2
    swDaten.SecondReverseDirection = True
    swDaten.SecondColor = RGB(0, 0, 255)
    swDaten.ShowSectionCap = True
    swDaten.KeepCapColor = True
    swDaten.Redraw = True                       ' Rückmeldung für die Schnittkörper
    Debug.Print "Schnittkörper gültig: " & swModel.ModelViewManager.CreateSectionView(swDaten)

    Set swDaten = swModel.ModelViewManager.GetSectionViewData("")
    If Not swDaten Is Nothing Then
        Debug.Print "Schnitt 1: Abstand " & swDaten.FirstOffset * 1000 & " mm, Farbe " & swDaten.FirstColor
        Debug.Print "Schnitt 2 umgekehrt: " & swDaten.SecondReverseDirection
    End If
    swModel.ClearSelection2 True
End Sub

Bemerkungen

Anlegen: Erzeuge die Daten mit ModelViewManager.CreateSectionViewData, setze die Eigenschaften und lege die Schnittansicht mit ModelViewManager.CreateSectionView an. Die Ebenen wählst du vorher mit ModelDocExtension.SelectByID2 aus: für Schnitt 1 mit der Markierung 1, für Schnitt 2 mit 2, für Schnitt 3 mit 4. Körper oder Komponenten für den selektiven Schnitt wählst du mit 8 aus, für den transparenten Schnitt mit 32, jeweils vor den Ebenen. ModelViewManager.RemoveSectionView entfernt die Schnittansicht wieder.

Zuweisen: Die Hilfebeispiele weisen die Ebenen den Eigenschaften FirstPlane bis ThirdPlane ohne Set zu. So steht es auch hier.

Ändern: Ob Änderungen an den Daten aus ModelViewManager.GetSectionViewData auf die vorhandene Schnittansicht wirken, sagt die Hilfe nicht. Ihr Beispiel liest die Daten nur.

Einheiten: Für Abstände und Drehungen nennt die Hilfe keine Einheiten. Die Abstände sind Meter, die Drehungen vermutlich Bogenmaß: Das Hilfebeispiel setzt Abstände von 0.01 und Drehungen von 0.2967… (17°) und 0.1745… (10°). Die Farben sind RGB-Werte.

Abhängigkeiten: Selektiver Schnitt geht nur, wenn SectionViewData.SelectiveSection True ist. Zonen und transparenter Schnitt gehen nur mit SectionViewData.ZonalSection True. Zonale Schnitte brauchen eine Grafikkarte mit OpenGL 4.0.

Eigenschaften und Methoden

Eigenschaften 31, davon 31 beschrieben

NameBeschreibung
ExcludeSelectedItemsLiest oder setzt, ob die Körper oder Komponenten aus SelectiveSectioningList vom selektiven Schnitt ausgenommen oder als einzige geschnitten werden.
FirstColorLiest oder setzt die Farbe von Schnitt 1 der Schnittansicht.
FirstOffsetLiest oder setzt den Abstand von Schnitt 1 zu seiner Schnittebene.
FirstPlaneLiest oder setzt die Ebene oder ebene Fläche von Schnitt 1 der Schnittansicht.
FirstReverseDirectionLiest oder setzt, ob die Richtung von Schnitt 1 umgekehrt ist.
FirstRotationXLiest oder setzt die Drehung von Schnitt 1 um die x-Achse.
FirstRotationYLiest oder setzt die Drehung von Schnitt 1 um die y-Achse.
GraphicsOnlySectionLiest oder setzt, ob die Schnittansicht nur in der Grafik entsteht, ohne das Modell neu aufzubauen.
KeepCapColorLiest oder setzt, ob die Schnittflächen der Schnittansicht farbig dargestellt werden.
RedrawLiest oder setzt, ob ModelViewManager.CreateSectionView meldet, ob gültige Schnittkörper entstanden sind, statt nur, ob die Schnittansicht entstand.
SecondColorLiest oder setzt die Farbe von Schnitt 2 der Schnittansicht.
SecondOffsetLiest oder setzt den Abstand von Schnitt 2 zu seiner Schnittebene.
SecondPlaneLiest oder setzt die Ebene oder ebene Fläche von Schnitt 2 der Schnittansicht.
SecondReverseDirectionLiest oder setzt, ob die Richtung von Schnitt 2 umgekehrt ist.
SecondRotationXLiest oder setzt die Drehung von Schnitt 2 um die x-Achse.
SecondRotationYLiest oder setzt die Drehung von Schnitt 2 um die y-Achse.
SectionedZonesLiest oder setzt die Zonen, die ein zonaler Schnitt schneidet.
SectionTransparentItemsTransparentLiest oder setzt, ob die geschnittenen Körper oder Komponenten aus TransparencyList transparent geschnitten werden oder alle übrigen.
SelectiveSectionLiest oder setzt, ob die Schnittansicht nur bestimmte Körper oder Komponenten schneidet.
SelectiveSectioningListLiest oder setzt die Körper eines Mehrkörperteils oder die Komponenten einer Baugruppe für den selektiven Schnitt.
ShowSectionCapLiest oder setzt, ob die Schnittansicht Schnittflächen zeigt oder den Blick ins Innere frei lässt.
ThirdColorLiest oder setzt die Farbe von Schnitt 3 der Schnittansicht.
ThirdOffsetLiest oder setzt den Abstand von Schnitt 3 zu seiner Schnittebene.
ThirdPlaneLiest oder setzt die Ebene oder ebene Fläche von Schnitt 3 der Schnittansicht.
ThirdReverseDirectionLiest oder setzt, ob die Richtung von Schnitt 3 umgekehrt ist.
ThirdRotationXLiest oder setzt die Drehung von Schnitt 3 um die x-Achse.
ThirdRotationYLiest oder setzt die Drehung von Schnitt 3 um die y-Achse.
TransparencyListLiest oder setzt die geschnittenen Körper oder Komponenten für den transparenten Schnitt.
TransparencyValueLiest oder setzt, wie transparent die angegebenen Körper oder Komponenten beim transparenten Schnitt sind.
TransparentSectionLiest oder setzt, ob der transparente Schnitt eingeschaltet ist.
ZonalSectionLiest oder setzt, ob die Schnittansicht zonal oder planar schneidet.

Methoden 4, davon 4 beschrieben

NameBeschreibung
GetDynamicCenterTransformLiefert die Verschiebung zwischen der Modellmitte und der Ebene eines Schnitts.
GetFirstPlaneParametersLiefert Mittelpunkt und Normale der transformierten Ebene von Schnitt 1.
GetSecondPlaneParametersLiefert Mittelpunkt und Normale der transformierten Ebene von Schnitt 2.
GetThirdPlaneParametersLiefert Mittelpunkt und Normale der transformierten Ebene von Schnitt 3.

Siehe auch

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

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