Objekt · SldWorks
PrintSpecification-Objekt
Die Druckeinstellungen eines Dokuments für ModelDocExtension.PrintOut4: Drucker oder Datei, Seitenbereiche, Kopien, Maßstab und Druckoptionen für Zeichnungen.
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
ModelDocExtension.GetPrintSpecification: die Druckeinstellungen des Dokuments
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Collate | Liest oder setzt, ob beim Drucken mehrerer Kopien die Seiten sortiert werden. |
| ConvertToHighQuality | Liest oder setzt, ob Zeichenansichten in Entwurfsqualität zum Drucken in hohe Qualität umgewandelt werden. |
| CurrentSheet | Liefert die Nummer des aktuellen Blatts der Zeichnung. |
| FromScale | Liest oder setzt den ersten Wert („Von“) des eigenen Maßstabs für das aktuelle Blatt. |
| NumberOfCopies | Liest oder setzt die Zahl der Kopien. |
| PrintBackground | Liest oder setzt, ob der Hintergrund mitgedruckt wird. |
| PrintCrossHatchOnOutOfDateViews | Liest oder setzt, ob veraltete Zeichenansichten beim Drucken mit einer Kreuzschraffur markiert werden. |
| PrinterQueue | Liest oder setzt den Drucker, auf den gedruckt wird. |
| PrintFile | Liest oder setzt Pfad und Namen der Datei, in die gedruckt wird. |
| PrintRange | Liest oder setzt die Seitenbereiche, die gedruckt werden, als Array von Anfangs- und Endseiten. |
| PrintToFile | Liest oder setzt, ob in eine Datei oder auf einen Drucker gedruckt wird. |
| PrintWhiteItemsBlack | Liest oder setzt, ob weiße Linien und weißer Text schwarz gedruckt werden. |
| ScaleMethod | Liest 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. |
| SheetCount | Liefert die Zahl der Blätter der Zeichnung. |
| ToScale | Liest oder setzt den zweiten Wert („Bis“) des eigenen Maßstabs für das aktuelle Blatt. |
| XOrigin | Liest oder setzt die x-Koordinate des Ursprungs des Druckfensters. |
| YOrigin | Liest oder setzt die y-Koordinate des Ursprungs des Druckfensters. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| AddPrintRange | Fügt einen Bereich von Seiten hinzu, die gedruckt werden. |
| ResetPrintRange | Setzt die Seitenbereiche auf die Vorgabe zurück. |
| RestoreDefaults | Setzt 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.