SolidWorksMakroprogrammierung

Methode · View

InsertViewAsBlock-Methode (View)

Wandelt die Zeichenansicht in einen Skizzenblock um und setzt dessen Manipulator an eine Stelle auf dem Blatt.

Syntax

Function InsertViewAsBlock( _
   ByVal InsertionPoint As MathPoint, _
   ByVal Position As MathPoint _
) As Boolean
bErfolg = swView.InsertViewAsBlock(swEinfuegePunkt, swZielPunkt)

Parameter

InsertionPointMathPointByVal
Punkt in dieser Ansicht, an dem der Manipulator des neuen Skizzenblocks liegt. Einheit und Koordinatensystem nennt die Hilfe nicht.
PositionMathPointByVal
Punkt auf dem Blatt, an den der Manipulator des Blocks gesetzt wird. Die Hilfe nennt keine Einheit; Meter in Blattkoordinaten liegen nahe, sind aber nicht belegt.

Rückgabewert

True, wenn die Ansicht in einen Skizzenblock umgewandelt wurde, sonst False.

Beispiel

' swApp ist SOLIDWORKS (SldWorks), swView eine Zeichenansicht (View), etwa aus DrawingDoc.ActiveDrawingView oder der Auswahl.
Dim swMathUtil As SldWorks.MathUtility
Dim swEinfuegePunkt As SldWorks.MathPoint
Dim swZielPunkt As SldWorks.MathPoint
Dim dPunkt(2) As Double
Dim vPunkt As Variant
Dim vLage As Variant
Dim bErfolg As Boolean
Set swMathUtil = swApp.GetMathUtility
vPunkt = dPunkt                         ' Manipulator bei (0, 0, 0) der Ansicht
Set swEinfuegePunkt = swMathUtil.CreatePoint(vPunkt)
vLage = swView.Position                 ' bisherige Mitte der Ansicht auf dem Blatt
dPunkt(0) = vLage(0): dPunkt(1) = vLage(1): dPunkt(2) = 0
vPunkt = dPunkt
Set swZielPunkt = swMathUtil.CreatePoint(vPunkt)
bErfolg = swView.InsertViewAsBlock(swEinfuegePunkt, swZielPunkt)
Debug.Print "In Skizzenblock umgewandelt: " & bErfolg

Bemerkungen

Die Punkte erzeugst du mit MathUtility.CreatePoint aus einem Array mit drei Double-Werten (X, Y, Z). Die Hilfe sagt nicht, in welchem Koordinatensystem InsertionPoint gemessen wird und wo der Punkt (0, 0, 0) der Ansicht liegt. Das Beispiel nimmt an, dass beide Punkte in Metern angegeben werden; probier es im eigenen Modell aus, bevor du dich darauf verlässt.

Die Ansicht wird in einen Skizzenblock umgewandelt. Ob die Zeichenansicht danach noch als Ansicht existiert, sagt die Hilfe nicht ausdrücklich. Benutz swView nach dem Aufruf besser nicht mehr.

Verwandte Befehle: View.ReplaceViewWithBlock wandelt die Ansicht ebenfalls in einen Skizzenblock um, bekommt aber nur den Einfügepunkt und keine Zielposition. View.ReplaceViewWithSketch wandelt die Ansicht in eine Skizze um.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2013

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

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