PageSettings Klasse

Definition

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Assembly:

System.Drawing.dll

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

Object

PageSettings

Attribute

ComVisibleAttribute SerializableAttribute

Implementiert

ICloneable

Beispiele

Im folgenden Beispiel wird die Behandlung des Ereignisses veranschaulicht und das PrintPage PageSettings Argument überprüft PrintPageEventArgs. Um diesen Code zu verwenden, fügen Sie einer Windows Form eine PrintDocument Komponente PrintDocument1 hinzu, und zuordnen Sie das PrintPage Ereignis mit der printDocument1_PrintPage Methode im Beispiel.

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 auf einer Seiten-nach-Seite-Basis anzugeben, behandeln Sie das Argument oder PrintDocument.QueryPageSettings QueryPageSettingsEventArgsdas PrintDocument.PrintPage Ereignis und ändern Sie das PageSettings argument, das in der oder oder dem PrintPageEventArgs jeweiligen Typ enthalten ist.

Weitere Informationen zum Behandeln 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öher wird das System.Drawing.Common-Paket,das diesen Typ enthält, nur auf Windows Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps verursacht Warnungen zur Kompilierzeit und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur für 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.

Siehe auch

• PrintDocument
• PrinterSettings