SolidWorksMakroprogrammierung

Objekt · SldWorks

PrintSpecification-Objekt

Die Druckeinstellungen eines Dokuments für ModelDocExtension.PrintOut4: Drucker oder Datei, Seitenbereiche, Kopien, Maßstab und Druckoptionen für Zeichnungen.

Deklaration Dim x As SldWorks.PrintSpecification · in der englischen .NET-Hilfe: IPrintSpecification

Beschreibung

PrintSpecification gibt Zugriff auf die Druckeinstellungen eines Dokuments. Du holst sie mit ModelDocExtension.GetPrintSpecification, stellst sie ein und übergibst sie an ModelDocExtension.PrintOut4, das ohne Dialoge druckt. Die Befehle gibt es seit SOLIDWORKS 2015.

Zugriff

Beispiel

' Druckt das erste Blatt der aktiven Zeichnung zweimal auf den Standarddrucker
' des Dokuments und setzt die Druckeinstellungen danach zurück.
' Vorbedingung: Eine Zeichnung ist offen, ein Drucker ist eingerichtet.
' Ergebnis:     Zwei Ausdrucke von Blatt 1, die Einstellungen stehen im
'               Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDruck As SldWorks.PrintSpecification

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub

    Set swDruck = swModel.Extension.GetPrintSpecification
    Debug.Print "Blätter:        " & swDruck.SheetCount
    Debug.Print "Aktuelles Blatt: " & swDruck.CurrentSheet
    Debug.Print "Drucker:        " & swDruck.PrinterQueue
    Debug.Print "Maßstab:        " & swDruck.ScaleMethod   ' Wert aus swPrintSelectionScaleFactor_e

    swDruck.ResetPrintRange
    swDruck.AddPrintRange 1, 1
    swDruck.NumberOfCopies = 2
    swDruck.Collate = True
    swDruck.ConvertToHighQuality = True
    swDruck.PrintToFile = False

    swModel.Extension.PrintOut4 "", "", swDruck

    swDruck.RestoreDefaults
    swDruck.ResetPrintRange
End Sub

Bemerkungen

Hilfebeispiel: „Print Drawing“ öffnet die Zeichnung foodprocessor.slddrw, setzt eine Fußzeile über die Seiteneinrichtung (ModelDoc2.PageSetup), holt die Druckeinstellungen und setzt ConvertToHighQuality, einen Seitenbereich 1 bis 1, den Maßstab 1,5 zu 0,5 mit swPrintSelection, einen leeren PrinterQueue und PrintToFile = False. Dann gibt es alle Eigenschaften aus, druckt mit ModelDocExtension.PrintOut4 auf den Standarddrucker und ruft zuletzt RestoreDefaults und ResetPrintRange auf.

Reihenfolge beim Drucken: Nach ModelDocExtension.PrintOut4 holst du zuerst die Druckeinstellungen, setzt dann PrintToFile (True druckt in die Datei aus PrintFileName, False auf den Drucker aus Printer), stellst die übrigen Eigenschaften ein und übergibst das Objekt als Parameter PrintSpecification. Ohne Drucker, Datei und Druckeinstellungen druckt PrintOut4 auf den Drucker aus ModelDoc2.Printer.

Zeichnungen: Blätter, Maßstab und die Optionen für Ansichten betreffen Zeichnungen. Auf der Seite zu PrintOut4 steht aber, dass sie auch Teile und Baugruppen druckt. Welche Eigenschaften dort wirken, sagt die Hilfe nicht.

Bleiben die Einstellungen? Ob die Druckeinstellungen nach dem Drucken im Dokument erhalten bleiben, sagt die Hilfe nicht. Das Hilfebeispiel setzt sie am Ende mit PrintSpecification.RestoreDefaults und PrintSpecification.ResetPrintRange zurück, das Beispiel oben ebenso.

Eigenschaften und Methoden

Eigenschaften 17, davon 17 beschrieben

NameBeschreibung
CollateLiest oder setzt, ob beim Drucken mehrerer Kopien die Seiten sortiert werden.
ConvertToHighQualityLiest oder setzt, ob Zeichenansichten in Entwurfsqualität zum Drucken in hohe Qualität umgewandelt werden.
CurrentSheetLiefert die Nummer des aktuellen Blatts der Zeichnung.
FromScaleLiest oder setzt den ersten Wert („Von“) des eigenen Maßstabs für das aktuelle Blatt.
NumberOfCopiesLiest oder setzt die Zahl der Kopien.
PrintBackgroundLiest oder setzt, ob der Hintergrund mitgedruckt wird.
PrintCrossHatchOnOutOfDateViewsLiest oder setzt, ob veraltete Zeichenansichten beim Drucken mit einer Kreuzschraffur markiert werden.
PrinterQueueLiest oder setzt den Drucker, auf den gedruckt wird.
PrintFileLiest oder setzt Pfad und Namen der Datei, in die gedruckt wird.
PrintRangeLiest oder setzt die Seitenbereiche, die gedruckt werden, als Array von Anfangs- und Endseiten.
PrintToFileLiest oder setzt, ob in eine Datei oder auf einen Drucker gedruckt wird.
PrintWhiteItemsBlackLiest oder setzt, ob weiße Linien und weißer Text schwarz gedruckt werden.
ScaleMethodLiest oder setzt, was von der Zeichnung gedruckt wird und in welchem Maßstab: alles, das aktuelle Blatt 1:1, das Bildschirmbild oder ein eigener Maßstab.
SheetCountLiefert die Zahl der Blätter der Zeichnung.
ToScaleLiest oder setzt den zweiten Wert („Bis“) des eigenen Maßstabs für das aktuelle Blatt.
XOriginLiest oder setzt die x-Koordinate des Ursprungs des Druckfensters.
YOriginLiest oder setzt die y-Koordinate des Ursprungs des Druckfensters.

Methoden 3, davon 3 beschrieben

NameBeschreibung
AddPrintRangeFügt einen Bereich von Seiten hinzu, die gedruckt werden.
ResetPrintRangeSetzt die Seitenbereiche auf die Vorgabe zurück.
RestoreDefaultsSetzt alle Druckeinstellungen auf die Vorgabe zurück.

Siehe auch

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

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