Objekt · SldWorks
PageSetup-Objekt
Die Seiteneinrichtung zum Drucken: Papier, Ausrichtung, Maßstab, Auflösung, Farbe sowie Kopf- und Fußzeile, für das Programm, ein Dokument oder ein Zeichenblatt.
Beschreibung
PageSetup gibt Zugriff auf Einstellungen für Drucker und Seite, darunter Kopf- und Fußzeile. Eine Seiteneinrichtung gibt es auf drei Ebenen: für das Programm, für ein Dokument und für jedes Zeichenblatt. Welche davon beim Drucken gilt, legst du mit ModelDocExtension.UsePageSetup fest. Die meisten Befehle gibt es seit SOLIDWORKS 2001Plus, ScaleDraftEdges als jüngsten seit SOLIDWORKS 2015.
Zugriff
ModelDoc2.PageSetup: die Seiteneinrichtung des DokumentsModelDocExtension.AppPageSetup: die Seiteneinrichtung des Programms, geholt über das DokumentSheet.PageSetup: die Seiteneinrichtung eines Zeichenblatts
Beispiel
' Stellt die aktive Zeichnung auf ihre eigene Seiteneinrichtung um, gibt deren
' Werte aus und setzt Querformat, Anpassen an das Papier und eine Fußzeile.
' Vorbedingung: Eine Zeichnung ist offen.
' Ergebnis: Die bisherigen Werte stehen im Direktfenster (Strg+G), die neuen
' gelten beim nächsten Drucken der Zeichnung.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSeite As SldWorks.PageSetup
Dim sNummer As String, sAnzahl As String
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocDRAWING Then Exit Sub
swModel.Extension.UsePageSetup = swPageSetupInUse_Document
Set swSeite = swModel.PageSetup
Debug.Print "Ausrichtung: " & swSeite.Orientation ' Wert aus swPageSetupOrientation_e
Debug.Print "Papierformat: " & swSeite.PrinterPaperSize ' Nummer aus Windows bzw. vom Drucker
Debug.Print "Anpassen: " & swSeite.ScaleToFit & ", sonst Maßstab " & swSeite.Scale2
Debug.Print "Hohe Qualität: " & swSeite.HighQuality
Debug.Print "Farbe: " & swSeite.DrawingColor ' Wert aus swPageSetupDrawingColor_e
If swSeite.GetUseDefaultResolution Then
Debug.Print "Auflösung: Vorgabe des Druckers"
Else
Debug.Print "Auflösung: " & swSeite.GetResolution & " dpi"
End If
Debug.Print "Fußzeile: " & swSeite.LeftFooter & " | " & swSeite.CenterFooter & " | " & swSeite.RightFooter
swSeite.Orientation = swPageSetupOrient_Landscape
swSeite.ScaleToFit = True
sNummer = swSeite.GetHeaderFooterString(swHeaderFooterText_PageNumber)
sAnzahl = swSeite.GetHeaderFooterString(swHeaderFooterText_PageCount)
swSeite.SetFooter swSeite.GetHeaderFooterString(swHeaderFooterText_Filename), _
"Seite " & sNummer & " von " & sAnzahl, swSeite.GetHeaderFooterString(swHeaderFooterText_Date)
End SubBemerkungen
Welche Seiteneinrichtung gilt: Es hängt von einer Einstellung des Dokuments ab, welche Seiteneinrichtung beim Drucken benutzt wird. Du liest und setzt sie mit ModelDocExtension.UsePageSetup (Werte aus swPageSetupInUse_e): Programm (ModelDocExtension.AppPageSetup), Dokument (ModelDoc2.PageSetup) oder jedes Zeichenblatt einzeln (Sheet.PageSetup). Ob Änderungen an einer Seiteneinrichtung, die gerade nicht gilt, beim Drucken etwas bewirken, sagt die Hilfe nicht. Das Beispiel stellt deshalb vorher um, wie das Hilfebeispiel „Print Drawing“.
Programm: Obwohl ModelDocExtension.AppPageSetup die Werte des Programms liefert, hängen nach Angabe der Hilfe einige davon vom Dokumenttyp ab. Hol das Objekt deshalb für jedes Dokument neu, das du druckst.
Zeichenblätter: Jedes Blatt kann die Werte der Seiteneinrichtung mit eigenen Werten überschreiben. PageSetup.DrawingColor setzt du nur auf Programm- oder Dokumentebene.
Drucken: Gedruckt wird etwa mit ModelDocExtension.PrintOut4. Seitenbereiche, Kopien und den Maßstab für Zeichnungen stellst du dabei über PrintSpecification ein. Wie diese Werte mit Scale2, ScaleToFit und HighQuality zusammenwirken, sagt die Hilfe nicht.
Hilfebeispiele: „Print Drawing“ setzt mit PageSetup.GetHeaderFooterString die Fußzeile „x of y“, „Get Whether Draft Edges Scaled in Printed Drawing“ liest HighQuality und ScaleDraftEdges an der Seiteneinrichtung des Programms, und „Print Drawing and Save as PDF“ stellt die Seiteneinrichtung einer Zeichnung auf Querformat.
Eigenschaften und Methoden
Eigenschaften 19, davon 18 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| CenterFooter | Liest oder setzt den Text in der Mitte der Fußzeile. |
| CenterHeader | Liest oder setzt den Text in der Mitte der Kopfzeile. |
| DrawingColor | Liest oder setzt, ob automatisch, farbig bzw. in Graustufen oder schwarzweiß gedruckt wird. |
| FooterTextFormat | Liefert das Textformat der Fußzeile, über das du etwa die Schriftart änderst. |
| HeaderTextFormat | Liefert das Textformat der Kopfzeile, über das du etwa die Schriftart änderst. |
| HighQuality | Liest oder setzt, ob eine Zeichnung in hoher Qualität gedruckt wird. |
| LeftFooter | Liest oder setzt den Text links in der Fußzeile. |
| LeftHeader | Liest oder setzt den Text links in der Kopfzeile. |
| Orientation | Liest oder setzt, ob im Hochformat oder im Querformat gedruckt wird. |
| PrinterPaperLength | Liest oder setzt die Länge eines eigenen Papierformats in Zehntelmillimetern. |
| PrinterPaperSize | Liest oder setzt das Papierformat des Druckers für das Dokument oder Zeichenblatt. |
| PrinterPaperSource | Liest oder setzt die Papierquelle des Druckers, etwa den Papierschacht, für das Dokument oder Zeichenblatt. |
| PrinterPaperWidth | Liest oder setzt die Breite eines eigenen Papierformats in Zehntelmillimetern. |
| RightFooter | Liest oder setzt den Text rechts in der Fußzeile. |
| RightHeader | Liest oder setzt den Text rechts in der Kopfzeile. |
| Scale2 | Liest oder setzt den Maßstab, mit dem die Seite gedruckt wird, von 1 % bis 1000 %. |
| ScaleDraftEdges | Liest oder setzt, ob beim Drucken einer Zeichnung in hoher Qualität die Entwurfskanten skaliert werden. |
| ScaleToFit | Liest oder setzt, ob die Seite an das Papier des Druckers angepasst wird. |
| UsePageSetupOnSheets | veraltet ersetzt durch ModelDocExtension.UsePageSetup |
Methoden 6, davon 6 beschrieben
| Name | Beschreibung |
|---|---|
| GetHeaderFooterString | Liefert den Standardtext für Seitenzahl, Seitenanzahl, Datum, Uhrzeit oder Dateiname, den du in Kopf- und Fußzeile einsetzt. |
| GetResolution | Liefert die Druckauflösung des Dokuments oder Zeichenblatts. |
| GetUseDefaultResolution | Liefert, ob die Standardauflösung des Druckers gilt. |
| SetFooter | Setzt die ganze Fußzeile: Text links, in der Mitte und rechts. |
| SetHeader | Setzt die ganze Kopfzeile: Text links, in der Mitte und rechts. |
| SetResolution | Setzt die Druckauflösung des Dokuments oder Zeichenblatts oder schaltet auf die Standardauflösung des Druckers. |
Siehe auch
Englisches Original: IPageSetup in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.