SolidWorksMakroprogrammierung

Methode · View

SetXform-Methode (View)

Setzt Lage und Maßstab einer Zeichenansicht auf dem Blatt in einem Schritt.

Syntax

Function SetXform( _
   ByVal Transform As Variant _
) As Boolean
bErfolg = swView.SetXform(vXform)

Parameter

TransformVariantByVal

Array aus drei 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

Die Hilfe nennt für die Lage keine Einheit, wie alle Blattkoordinaten sind es Meter. Am einfachsten holst du das Array mit View.GetXform und änderst nur, was du brauchst.

Rückgabewert

True, wenn Lage und Maßstab gesetzt wurden, sonst False.

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swView eine Zeichenansicht (View) darin.
Dim vXform As Variant
Dim bErfolg As Boolean
vXform = swView.GetXform
Debug.Print swView.GetName2 & ": Maßstab vorher " & vXform(2)
vXform(2) = 0.5                        ' Maßstab 1:2, X und Y bleiben
bErfolg = swView.SetXform(vXform)
If bErfolg Then
    swModel.EditRebuild3
    Debug.Print "Maßstab jetzt " & swView.ScaleDecimal
Else
    Debug.Print "SetXform hat nicht geklappt."
End If

Bemerkungen

SetXform entspricht dem Setzen von View.Position (X und Y) und View.ScaleDecimal (Maßstab).

Ausrichtungen behandelt SOLIDWORKS so, als würdest du die Ansicht in der Oberfläche ziehen: Ist sie an einer anderen Ansicht ausgerichtet, bewegt sie sich nur entlang dieser Ausrichtung. Kindansichten, die an ihr ausgerichtet sind, wandern mit. Soll das nicht passieren, nimm ab SOLIDWORKS 2026 View.SetViewPosition.

Der Befehl kann die Grafik der Zeichnung ändern. Rufe nach allen Änderungen an den Ansichten ModelDoc2.EditRebuild3 auf, damit sie sichtbar werden.

Ob eine Ansicht, die den Maßstab des Blatts oder der übergeordneten Ansicht übernimmt (View.UseSheetScale, View.UseParentScale), dabei einen eigenen Maßstab bekommt, sagt die Hilfe nicht. Prüf das Ergebnis mit View.ScaleDecimal, wie im Beispiel.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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