PageSettings Klasse

Definition

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

PageSettings.cs

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

public ref class PageSettings : ICloneable

public class PageSettings : ICloneable

type PageSettings = class
    interface ICloneable

Public Class PageSettings
Implements ICloneable

Vererbung

Object

PageSettings

Implementiert

ICloneable

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.

Weitere Informationen

• PrintDocument
• PrinterSettings