SolidWorksMakroprogrammierung

Methode · DrawingDoc

TranslateDrawing-Methode (DrawingDoc)

Verschiebt die gesamte Zeichnung um einen Versatz in X und Y.

Syntax

Sub TranslateDrawing( _
   ByVal DeltaX As Double, _
   ByVal DeltaY As Double _
)
swDraw.TranslateDrawing 0.01, 0

Parameter

DeltaXDoubleByVal
Verschiebung in X-Richtung. Die Hilfe nennt keine Einheit, vermutlich Meter wie sonst in der API.
DeltaYDoubleByVal
Verschiebung in Y-Richtung, sonst wie DeltaX.

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
Dim swView As SldWorks.View
Dim vVorher As Variant, vNachher As Variant
Set swView = swDraw.GetFirstView    ' das Blatt
Set swView = swView.GetNextView     ' erste Zeichenansicht
If swView Is Nothing Then
    Debug.Print "Keine Zeichenansicht auf dem Blatt."
Else
    vVorher = swView.Position
    swDraw.TranslateDrawing 0.01, 0.005    ' vermutlich 10 mm nach rechts, 5 mm nach oben
    vNachher = swView.Position
    Debug.Print swView.GetName2 & " verschoben um " & (vNachher(0) - vVorher(0)) * 1000 & _
        " mm in X und " & (vNachher(1) - vVorher(1)) * 1000 & " mm in Y"
End If

Bemerkungen

Die Hilfe sagt nur, dass der Befehl die ganze Zeichnung verschiebt. Offen lässt sie:

  • die Einheit von DeltaX und DeltaY (vermutlich Meter) und die Richtung (vermutlich wie die Blattkoordinaten, also X nach rechts und Y nach oben),
  • ob nur das aktuelle Blatt oder alle Blätter betroffen sind,
  • ob außer den Zeichenansichten auch Skizzenelemente, Hinweise und das Blattformat mitwandern,
  • ob die Grafik danach neu gezeichnet werden muss. Falls die Anzeige nicht nachzieht, hilft vermutlich ModelView.GraphicsRedraw.

Das Beispiel zeigt an der Position einer Ansicht (View.Position), was tatsächlich passiert ist. Probier den Befehl an einer Kopie der Zeichnung aus, bevor du dich darauf verlässt. Eine einzelne Ansicht verschiebst du über View.Position.

DeltaX und DeltaY stehen in Metern, positive Werte verschieben nach rechts und oben: Mit 0.01, 0.005 wandert eine Zeichenansicht um 10 mm nach rechts und 5 mm nach oben.

Siehe auch

Verfügbarkeit

SOLIDWORKS 99

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

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