SolidWorksMakroprogrammierung

Methode · DrawingDoc

CreateUnfoldedViewAt3-Methode (DrawingDoc)

Erzeugt aus der ausgewählten Zeichenansicht eine abgeleitete Ansicht (englisch „unfolded view“) und setzt sie an die angegebene Stelle.

Syntax

Function CreateUnfoldedViewAt3( _
   ByVal X As Double, _
   ByVal Y As Double, _
   ByVal Z As Double, _
   ByVal NotAligned As Boolean _
) As View
Set swView = swDraw.CreateUnfoldedViewAt3(0.3, 0.15, 0, False)

Parameter

XDoubleByVal
X-Koordinate des Mittelpunkts der neuen Ansicht 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.
NotAlignedBooleanByVal
True hebt die Ausrichtung zur Elternansicht auf, False lässt die neue Ansicht an der Elternansicht ausgerichtet.

Rückgabewert

Die neue Zeichenansicht (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 swView As SldWorks.View
Dim bErfolg As Boolean
bErfolg = swModel.Extension.SelectByID2("Zeichenansicht1", "DRAWINGVIEW", 0, 0, 0, False, 0, Nothing, 0)
If bErfolg Then
    ' Mittelpunkt der neuen Ansicht bei x = 300 mm, y = 150 mm, ausgerichtet lassen
    Set swView = swDraw.CreateUnfoldedViewAt3(0.3, 0.15, 0, False)
    If Not swView Is Nothing Then
        Debug.Print "Neu: " & swView.GetName2
        If swView.Type = swDrawingProjectedView Then Debug.Print "Das ist eine Projizierte Ansicht."
    End If
End If

Bemerkungen

Wähl vor dem Aufruf die Zeichenansicht aus, von der die neue Ansicht abgeleitet wird, zum Beispiel mit ModelDocExtension.SelectByID2 und dem Typ "DRAWINGVIEW". Im Beispiel heißt sie „Zeichenansicht1“, in einer englischen Zeichnung „Drawing View1“.

Was eine „unfolded view“ genau ist, erklärt die Hilfe auf dieser Seite nicht. In swDrawingViewTypes_e steht swDrawingProjectedView (4) für „Projected (unfolded) view“. Vermutlich entsteht also eine Projizierte Ansicht. Prüf das mit View.Type wie im Beispiel, bevor du dich darauf verlässt.

Ersetzt DrawingDoc.CreateUnfoldedViewAt2.

Die neue Ansicht ist eine Projizierte Ansicht: View.Type liefert dafür swDrawingProjectedView (4).

Siehe auch

Verfügbarkeit

SOLIDWORKS 2005

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

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