SolidWorksMakroprogrammierung

Methode · DrawingDoc

CreateAuxiliaryViewAt2-Methode (DrawingDoc)

Erzeugt eine Hilfsansicht zu einer ausgewählten Kante einer Zeichenansicht und setzt sie an die angegebene Stelle.

Syntax

Function CreateAuxiliaryViewAt2( _
   ByVal X As Double, _
   ByVal Y As Double, _
   ByVal Z As Double, _
   ByVal NotAligned As Boolean, _
   ByVal Label As String, _
   ByVal Showarrow As Boolean, _
   ByVal Flip As Boolean _
) As Object
Set swView = swDraw.CreateAuxiliaryViewAt2(0.3, 0.15, 0, False, "A", True, False)

Parameter

XDoubleByVal
X-Koordinate der Stelle, an der die Hilfsansicht entsteht. Die Hilfe nennt keine Einheit. Beim Vorgänger spricht sie von einer Stelle auf dem Blatt, gemeint sind also vermutlich Blattkoordinaten in Metern ab der linken unteren Ecke. Ob es die Mitte der Ansicht ist, sagt die Hilfe nicht.
YDoubleByVal
Wie X, für die Y-Koordinate.
ZDoubleByVal
Wie X, für die Z-Koordinate. Auf dem Blatt vermutlich 0.
NotAlignedBooleanByVal
Ausrichtung an der Ansicht, aus der die Hilfsansicht entsteht. True richtet die Hilfsansicht daran aus, False nicht. Der Name „NotAligned“ (nicht ausgerichtet) lässt eher das Gegenteil erwarten. Probier es in der eigenen Zeichnung aus, bevor du dich darauf verlässt.
LabelStringByVal
Die Ansichtsbeschriftung, zum Beispiel "A".
ShowarrowBooleanByVal
True zeigt den Ansichtspfeil, False blendet ihn aus.
FlipBooleanByVal
True kehrt die Seite um, die die Hilfsansicht zeigt, False lässt sie, wie sie ist.

Rückgabewert

Die neue Hilfsansicht als 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.
' In einer Zeichenansicht ist eine gerade Kante ausgewählt.
Dim swSelMgr As SldWorks.SelectionMgr
Dim swView As SldWorks.View
Dim swHilfsansicht As SldWorks.View
Dim vPos As Variant
Set swSelMgr = swModel.SelectionManager
Set swView = swSelMgr.GetSelectedObjectsDrawingView2(1, -1)
If Not swView Is Nothing Then
    vPos = swView.Position
    Set swHilfsansicht = swDraw.CreateAuxiliaryViewAt2(vPos(0) + 0.12, vPos(1), 0, False, "A", True, False)
End If
If swHilfsansicht Is Nothing Then
    Debug.Print "Keine Hilfsansicht erzeugt. Ist eine Kante ausgewählt?"
Else
    Debug.Print swHilfsansicht.GetName2 & ", Hilfsansicht: " & (swHilfsansicht.Type = swDrawingAuxiliaryView)
End If

Bemerkungen

Vor dem Aufruf wählst du in einer Zeichenansicht die Kante aus, auf die sich die Hilfsansicht bezieht. Das Beispiel holt sich über SelectionMgr.GetSelectedObjectsDrawingView2 die Ansicht dieser Kante und setzt die Hilfsansicht neben deren Mitte (View.Position). Ob die Hilfsansicht wirklich genau an diese Stelle kommt, wenn sie ausgerichtet ist, sagt die Hilfe nicht.

Ersetzt DrawingDoc.CreateAuxiliaryViewAt, der nur X, Y, Z und NotAligned kannte und True oder False zurückgab. Weitere Ansichten erzeugst du mit DrawingDoc.CreateDetailViewAt4 (Detailansicht) und DrawingDoc.CreateSectionViewAt5 (Schnittansicht).

Siehe auch

Verfügbarkeit

SOLIDWORKS 2001

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

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