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.
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
ModelViewManager.CreateSectionViewData: neue Daten, danach legtModelViewManager.CreateSectionViewdie Schnittansicht anModelViewManager.GetSectionViewData: die Daten einer vorhandenen Schnittansicht, mit leerem Namen die aktive
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| ExcludeSelectedItems | Liest oder setzt, ob die Körper oder Komponenten aus SelectiveSectioningList vom selektiven Schnitt ausgenommen oder als einzige geschnitten werden. |
| FirstColor | Liest oder setzt die Farbe von Schnitt 1 der Schnittansicht. |
| FirstOffset | Liest oder setzt den Abstand von Schnitt 1 zu seiner Schnittebene. |
| FirstPlane | Liest oder setzt die Ebene oder ebene Fläche von Schnitt 1 der Schnittansicht. |
| FirstReverseDirection | Liest oder setzt, ob die Richtung von Schnitt 1 umgekehrt ist. |
| FirstRotationX | Liest oder setzt die Drehung von Schnitt 1 um die x-Achse. |
| FirstRotationY | Liest oder setzt die Drehung von Schnitt 1 um die y-Achse. |
| GraphicsOnlySection | Liest oder setzt, ob die Schnittansicht nur in der Grafik entsteht, ohne das Modell neu aufzubauen. |
| KeepCapColor | Liest oder setzt, ob die Schnittflächen der Schnittansicht farbig dargestellt werden. |
| Redraw | Liest oder setzt, ob ModelViewManager.CreateSectionView meldet, ob gültige Schnittkörper entstanden sind, statt nur, ob die Schnittansicht entstand. |
| SecondColor | Liest oder setzt die Farbe von Schnitt 2 der Schnittansicht. |
| SecondOffset | Liest oder setzt den Abstand von Schnitt 2 zu seiner Schnittebene. |
| SecondPlane | Liest oder setzt die Ebene oder ebene Fläche von Schnitt 2 der Schnittansicht. |
| SecondReverseDirection | Liest oder setzt, ob die Richtung von Schnitt 2 umgekehrt ist. |
| SecondRotationX | Liest oder setzt die Drehung von Schnitt 2 um die x-Achse. |
| SecondRotationY | Liest oder setzt die Drehung von Schnitt 2 um die y-Achse. |
| SectionedZones | Liest oder setzt die Zonen, die ein zonaler Schnitt schneidet. |
| SectionTransparentItemsTransparent | Liest oder setzt, ob die geschnittenen Körper oder Komponenten aus TransparencyList transparent geschnitten werden oder alle übrigen. |
| SelectiveSection | Liest oder setzt, ob die Schnittansicht nur bestimmte Körper oder Komponenten schneidet. |
| SelectiveSectioningList | Liest oder setzt die Körper eines Mehrkörperteils oder die Komponenten einer Baugruppe für den selektiven Schnitt. |
| ShowSectionCap | Liest oder setzt, ob die Schnittansicht Schnittflächen zeigt oder den Blick ins Innere frei lässt. |
| ThirdColor | Liest oder setzt die Farbe von Schnitt 3 der Schnittansicht. |
| ThirdOffset | Liest oder setzt den Abstand von Schnitt 3 zu seiner Schnittebene. |
| ThirdPlane | Liest oder setzt die Ebene oder ebene Fläche von Schnitt 3 der Schnittansicht. |
| ThirdReverseDirection | Liest oder setzt, ob die Richtung von Schnitt 3 umgekehrt ist. |
| ThirdRotationX | Liest oder setzt die Drehung von Schnitt 3 um die x-Achse. |
| ThirdRotationY | Liest oder setzt die Drehung von Schnitt 3 um die y-Achse. |
| TransparencyList | Liest oder setzt die geschnittenen Körper oder Komponenten für den transparenten Schnitt. |
| TransparencyValue | Liest oder setzt, wie transparent die angegebenen Körper oder Komponenten beim transparenten Schnitt sind. |
| TransparentSection | Liest oder setzt, ob der transparente Schnitt eingeschaltet ist. |
| ZonalSection | Liest oder setzt, ob die Schnittansicht zonal oder planar schneidet. |
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| GetDynamicCenterTransform | Liefert die Verschiebung zwischen der Modellmitte und der Ebene eines Schnitts. |
| GetFirstPlaneParameters | Liefert Mittelpunkt und Normale der transformierten Ebene von Schnitt 1. |
| GetSecondPlaneParameters | Liefert Mittelpunkt und Normale der transformierten Ebene von Schnitt 2. |
| GetThirdPlaneParameters | Liefert 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.