Freigeben über


PageSettings Klasse

Definition

Gibt Einstellungen an, die auf eine einzelne gedruckte Seite angewendet werden.

public ref class PageSettings : ICloneable
public class PageSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
public class PageSettings : ICloneable
[System.Serializable]
public class PageSettings : ICloneable
type PageSettings = class
    interface ICloneable
[<System.Runtime.InteropServices.ComVisible(false)>]
type PageSettings = class
    interface ICloneable
[<System.Serializable>]
type PageSettings = class
    interface ICloneable
Public Class PageSettings
Implements ICloneable
Vererbung
PageSettings
Attribute
Implementiert

Beispiele

Im folgenden Beispiel wird die Behandlung des Ereignisses PrintPage und das Überprüfen des PageSettings Arguments von PrintPageEventArgsveranschaulicht. Um diesen Code zu verwenden, fügen Sie einer Windows Form eine PrintDocument Komponente mit dem Namen PrintDocument1 hinzu, und ordnen Sie ihr PrintPage Ereignis der printDocument1_PrintPage -Methode im Beispiel zu.

private void printDocument1_PrintPage(object sender, System.Drawing.Printing.PrintPageEventArgs e)
{
    if (e.PageSettings.Color && !printDocument1.PrinterSettings.SupportsColor)
        MessageBox.Show("Color printing not supported on selected printer.", "Printer Warning", MessageBoxButtons.OKCancel);
}
Private Sub printDocument1_PrintPage(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintPageEventArgs)  Handles printDocument1.PrintPage
    If e.PageSettings.Color AndAlso Not printDocument1.PrinterSettings.SupportsColor Then
        MessageBox.Show("Color printing not supported on selected printer.", "Printer Warning", MessageBoxButtons.OKCancel)
    End If

End Sub

Hinweise

Die PageSettings -Klasse wird verwendet, um Einstellungen anzugeben, die die Art und Weise ändern, wie eine Seite gedruckt wird. In der Regel legen Sie Standardeinstellungen für alle Seiten fest, die über die PrintDocument.DefaultPageSettings -Eigenschaft gedruckt werden sollen. Um Einstellungen seitenweise anzugeben, behandeln Sie das PrintDocument.PrintPage - oder PrintDocument.QueryPageSettings -Ereignis, und ändern Sie das PageSettings argument, das PrintPageEventArgsQueryPageSettingsEventArgsbzw. enthalten ist.

Weitere Informationen zur Behandlung von PrintDocument Ereignissen finden Sie in der PrintDocument Klassenübersicht. Weitere Informationen zum Drucken finden Sie in der System.Drawing.Printing Namespaceübersicht.

Hinweis

In .NET 6 und höheren Versionen wird das System.Drawing.Common-Paket, das diesen Typ enthält, nur unter Windows-Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps verursacht Kompilierzeitwarnungen und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Konstruktoren

PageSettings()

Initialisiert eine neue Instanz der PageSettings-Klasse, die den Standarddrucker verwendet.

PageSettings(PrinterSettings)

Initialisiert eine neue Instanz der PageSettings-Klasse mit einem angegebenen Drucker.

Eigenschaften

Bounds

Ruft die Größe der Seite ab, wobei die durch die Landscape-Eigenschaft angegebene Seitenausrichtung berücksichtigt wird.

Color

Ruft einen Wert ab, der angibt, ob die Seite in Farbe gedruckt werden soll, oder legt diesen fest.

HardMarginX

Ruft die x-Koordinate des druckerdefinierten linken Rands der Seite in 1/100 Zoll ab.

HardMarginY

Ruft die y-Koordinate des druckerdefinierten, oberen Rands der Seite in 1/100 Zoll ab.

Landscape

Ruft einen Wert ab, der angibt, ob die Seite im Querformat oder Hochformat gedruckt werden soll, oder legt diesen fest.

Margins

Ruft die Seitenränder für diese Seite ab oder legt diese fest.

PaperSize

Ruft die Papiergröße für diese Seite ab oder legt diese fest.

PaperSource

Ruft die Papierzufuhr für die Seite ab oder legt diese fest (z. B. den oberen Papierschacht des Druckers).

PrintableArea

Ruft die Grenzen des bedruckbaren Bereichs der Seite für den Drucker ab.

PrinterResolution

Ruft die Druckerauflösung für die Seite ab oder legt diese fest.

PrinterSettings

Ruft die Druckereinstellungen für die Seite ab oder legt diese fest.

Methoden

Clone()

Erstellt eine Kopie dieser Instanz von PageSettings.

CopyToHdevmode(IntPtr)

Kopiert die relevanten Informationen aus PageSettings in die angegebene DEVMODE-Struktur.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
SetHdevmode(IntPtr)

Kopiert relevante Informationen aus der angegebenen DEVMODE-Struktur in PageSettings.

ToString()

Konvertiert PageSettings in die Zeichenfolgenform.

Gilt für:

Weitere Informationen