Methode · DrawingDoc
CreateSectionViewAt5-Methode (DrawingDoc)
Erzeugt aus der ausgewählten Schnittlinie eine Schnittansicht und setzt sie an die angegebene Stelle auf dem Blatt.
Syntax
Function CreateSectionViewAt5( _
ByVal X As Double, _
ByVal Y As Double, _
ByVal Z As Double, _
ByVal SectionLabel As String, _
ByVal Options As Long, _
ByVal ExcludedComponents As Variant, _
ByVal SectionDepth As Double _
) As ViewSet swView = swDraw.CreateSectionViewAt5(0.25, 0.15, 0, "A", 0, vOhne, 0.02)Parameter
XDoubleByVal- X-Koordinate des Mittelpunkts der neuen Schnittansicht auf dem Blatt (Blattkoordinate in Metern).
YDoubleByVal- Y-Koordinate des Mittelpunkts auf dem Blatt.
ZDoubleByVal- Z-Koordinate des Mittelpunkts. Auf dem ebenen Blatt übergibst du 0.
SectionLabelStringByVal- Buchstabe für die Bezeichnung der Schnittansicht, etwa
"A". OptionsLongByValOptionen als Bitmaske aus
swCreateSectionViewAtOptions_e. Werte kombinierst du mitOr, 0 heißt: keine Option.swCreateSectionView_NotAligned(1): Die Ansicht wird nicht an der Elternansicht ausgerichtet.swCreateSectionView_OffsetSection(2): ausgerichteter Schnitt (zwei Linien im Winkel) statt normaler Projektion.swCreateSectionView_ChangeDirection(4): Richtung der Schnittansicht umkehren.swCreateSectionView_ScaleWithModel(8): Ansicht mit dem Modell skalieren.swCreateSectionView_Partial(16): Teilschnitt statt vollständigem Schnitt.swCreateSectionView_DisplaySurfaceCut(32): nur die von der Schnittlinie geschnittenen Flächen zeigen.swCreateSectionView_ExcludeFasteners(64): Verbindungselemente nicht in die Schnittansicht aufnehmen.swCreateSectionView_CutSurfaceBodies(128): von Flächenkörpern nur die Schnittlinie zeigen.
ExcludedComponentsVariantByVal- Array der Komponenten, die nicht geschnitten werden sollen. Welcher Objekttyp gemeint ist (vermutlich
Component2), sagt die Hilfe nicht. Willst du nichts ausschließen, übergib eine Variant, dieNothingenthält (siehe Beispiel). Diesen Fall beschreibt die Hilfe nicht ausdrücklich. SectionDepthDoubleByVal- Schnitttiefe: Abstand von der ausgewählten Schnittlinie. Die Hilfe nennt keine Einheit; wie alle Längen vermutlich Meter. Was 0 bewirkt (etwa keine Begrenzung), sagt sie nicht.
Rückgabewert
Die neue Schnittansicht (View). Was bei einem Fehler zurückkommt, sagt die Hilfe nicht. Prüf das Ergebnis mit Is Nothing.
Beispiel
' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
Dim swSkSeg As SldWorks.SketchSegment
Dim swView As SldWorks.View
Dim swSection As SldWorks.DrSection
Dim vOhne As Variant
Dim bErfolg As Boolean
' Schnittlinie in Zeichenansicht1 skizzieren (Koordinaten an dein Modell anpassen) und auswählen
bErfolg = swDraw.ActivateView("Zeichenansicht1")
swModel.ClearSelection2 True
Set swSkSeg = swModel.SketchManager.CreateLine(-0.05, 0, 0, 0.05, 0, 0)
bErfolg = swSkSeg.Select4(False, Nothing)
' Keine Komponenten ausschließen
Set vOhne = Nothing
Set swView = swDraw.CreateSectionViewAt5(0.25, 0.15, 0, "A", _
swCreateSectionView_NotAligned Or swCreateSectionView_DisplaySurfaceCut, vOhne, 0.02)
If swView Is Nothing Then
Debug.Print "Schnittansicht wurde nicht erzeugt."
Else
Set swSection = swView.GetSection
Debug.Print swView.GetName2 & ": Bezeichnung " & swSection.GetLabel & _
", Tiefe " & swSection.SectionDepth * 1000 & " mm"
End IfBemerkungen
Wähl vor dem Aufruf die Linie oder die Linien aus, die als Schnittlinie dienen sollen. Der Befehl läuft ohne Rückfrage: Anders als in der Oberfläche wird niemand nach einer Bezeichnung gefragt.
Die Bezeichnung änderst du danach über View.GetSection und DrSection.SetLabel2. SetLabel2 meldet eine Warnung, wenn die Bezeichnung schon vergeben ist und die Zeichnungsnorm doppelte Bezeichnungen nicht erlaubt. Die Schnitttiefe liest und ändert DrSection.SectionDepth.
Im Beispiel heißt die Ansicht „Zeichenansicht1“. In einer englischen Zeichnung heißt sie „Drawing View1“.
Ersetzt DrawingDoc.CreateSectionViewAt4.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2010
Englisches Original: IDrawingDoc::CreateSectionViewAt5 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.