SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.PageSetup · in der englischen .NET-Hilfe: IPageSetup

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

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 Sub

Bemerkungen

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

NameBeschreibung
CenterFooterLiest oder setzt den Text in der Mitte der Fußzeile.
CenterHeaderLiest oder setzt den Text in der Mitte der Kopfzeile.
DrawingColorLiest oder setzt, ob automatisch, farbig bzw. in Graustufen oder schwarzweiß gedruckt wird.
FooterTextFormatLiefert das Textformat der Fußzeile, über das du etwa die Schriftart änderst.
HeaderTextFormatLiefert das Textformat der Kopfzeile, über das du etwa die Schriftart änderst.
HighQualityLiest oder setzt, ob eine Zeichnung in hoher Qualität gedruckt wird.
LeftFooterLiest oder setzt den Text links in der Fußzeile.
LeftHeaderLiest oder setzt den Text links in der Kopfzeile.
OrientationLiest oder setzt, ob im Hochformat oder im Querformat gedruckt wird.
PrinterPaperLengthLiest oder setzt die Länge eines eigenen Papierformats in Zehntelmillimetern.
PrinterPaperSizeLiest oder setzt das Papierformat des Druckers für das Dokument oder Zeichenblatt.
PrinterPaperSourceLiest oder setzt die Papierquelle des Druckers, etwa den Papierschacht, für das Dokument oder Zeichenblatt.
PrinterPaperWidthLiest oder setzt die Breite eines eigenen Papierformats in Zehntelmillimetern.
RightFooterLiest oder setzt den Text rechts in der Fußzeile.
RightHeaderLiest oder setzt den Text rechts in der Kopfzeile.
Scale2Liest oder setzt den Maßstab, mit dem die Seite gedruckt wird, von 1 % bis 1000 %.
ScaleDraftEdgesLiest oder setzt, ob beim Drucken einer Zeichnung in hoher Qualität die Entwurfskanten skaliert werden.
ScaleToFitLiest oder setzt, ob die Seite an das Papier des Druckers angepasst wird.
UsePageSetupOnSheetsveraltet ersetzt durch ModelDocExtension.UsePageSetup

Methoden 6, davon 6 beschrieben

NameBeschreibung
GetHeaderFooterStringLiefert den Standardtext für Seitenzahl, Seitenanzahl, Datum, Uhrzeit oder Dateiname, den du in Kopf- und Fußzeile einsetzt.
GetResolutionLiefert die Druckauflösung des Dokuments oder Zeichenblatts.
GetUseDefaultResolutionLiefert, ob die Standardauflösung des Druckers gilt.
SetFooterSetzt die ganze Fußzeile: Text links, in der Mitte und rechts.
SetHeaderSetzt die ganze Kopfzeile: Text links, in der Mitte und rechts.
SetResolutionSetzt 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.