Methode · View
GetXform-Methode (View)
Liefert die Lage der Zeichenansicht auf dem Blatt und ihren Maßstab als Array aus drei Zahlen.
Syntax
Function GetXform() As VariantvXform = swView.GetXformRückgabewert
Ein Array mit 3 Double-Werten:
- (0): X-Lage der Ansicht, bezogen auf den Ursprung des Blatts
- (1): Y-Lage der Ansicht, bezogen auf den Ursprung des Blatts
- (2): Maßstab der Ansicht als Dezimalzahl, etwa 0,5 für 1:2
Beispiel
' swModel ist die aktive Zeichnung (ModelDoc2), swView eine Zeichenansicht darin.
Dim vXform As Variant
Dim bErfolg As Boolean
vXform = swView.GetXform
Debug.Print swView.GetName2 & ": X " & vXform(0) * 1000 & " mm, Y " & vXform(1) * 1000 & " mm, Maßstab " & vXform(2)
vXform(0) = vXform(0) + 0.01 ' Maßstab bleibt unverändert
bErfolg = swView.SetXform(vXform)
If bErfolg Then swModel.EditRebuild3Bemerkungen
Die Hilfe nennt für die Lage keine Einheit. Vermutlich sind es Meter wie bei allen Blattkoordinaten. Welcher Punkt der Ansicht gemeint ist, sagt die Seite auch nicht. Nach View.SetXform entspricht das Setzen dieser drei Werte dem Setzen von View.Position (Mittelpunkt der Ansicht) und View.ScaleDecimal. Es ist also vermutlich der Mittelpunkt.
Zurückschreiben geht mit View.SetXform. Danach baust du die Zeichnung mit ModelDoc2.EditRebuild3 neu auf, damit die Änderung sichtbar wird.
GetXform beschreibt nur die Lage auf dem Blatt. Die Transformation vom Ursprung des Modells zum Ursprung der Zeichnung liefert View.GetViewXform. Die Hilfe nennt außerdem View.ModelToViewTransform als verwandte Eigenschaft.
Der Befehl heißt GetXform mit kleinem f, nicht GetXForm.
Die Lage kommt in Metern zurück und ist der Mittelpunkt der Ansicht auf dem Blatt, also derselbe Punkt wie bei View.Position.
Siehe auch
Verfügbarkeit
In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.
Englisches Original: IView::GetXform in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.