PageSettings Klasa

Definicja

Przestrzeń nazw:

System.Drawing.Printing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

PageSettings.cs

Określa ustawienia, które mają zastosowanie do jednej wydrukowanej strony.

public ref class PageSettings : ICloneable

public class PageSettings : ICloneable

type PageSettings = class
    interface ICloneable

Public Class PageSettings
Implements ICloneable

Dziedziczenie

Object

PageSettings

Implementuje

ICloneable

Przykłady

W poniższym przykładzie pokazano obsługę PrintPage zdarzenia i sprawdzenie PageSettings argumentu .PrintPageEventArgs Aby użyć tego kodu, dodaj PrintDocument składnik o nazwie PrintDocument1 do formularza systemu Windows i skojarz jego PrintPage zdarzenie z printDocument1_PrintPage metodą w przykładzie.

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

Uwagi

Klasa służy do określania PageSettings ustawień, które modyfikują sposób drukowania strony. Zazwyczaj należy ustawić ustawienia domyślne dla wszystkich stron, które mają być drukowane za pomocą PrintDocument.DefaultPageSettings właściwości . Aby określić ustawienia na podstawie strony po stronie, obsłuż PrintDocument.PrintPage zdarzenie lub PrintDocument.QueryPageSettings i zmodyfikuj PageSettings odpowiednio argument uwzględniony w elememencie PrintPageEventArgs lub QueryPageSettingsEventArgs.

Aby uzyskać więcej informacji na temat obsługi zdarzeń PrintDocument , zobacz PrintDocument omówienie klasy. Aby uzyskać więcej informacji na temat drukowania, zobacz System.Drawing.Printing omówienie przestrzeni nazw.

Uwaga

W programie .NET 6 i nowszych wersjach pakiet System.Drawing.Common, który obejmuje ten typ, jest obsługiwany tylko w systemach operacyjnych Windows. Użycie tego typu w aplikacjach międzyplatformowych powoduje ostrzeżenia w czasie kompilacji i wyjątki czasu wykonywania. Aby uzyskać więcej informacji, zobacz System.Drawing.Common only supported on Windows (Obsługiwane tylko w systemie Windows).

Konstruktory

PageSettings()	Inicjuje PageSettings nowe wystąpienie klasy przy użyciu drukarki domyślnej.
PageSettings(PrinterSettings)	Inicjuje PageSettings nowe wystąpienie klasy przy użyciu określonej drukarki.

Właściwości

Bounds	Pobiera rozmiar strony, biorąc pod uwagę orientację strony określoną przez Landscape właściwość .
Color	Pobiera lub ustawia wartość wskazującą, czy strona powinna być drukowana w kolorze.
HardMarginX	Pobiera współrzędną x (w setnych częściach cala) z twardego marginesu po lewej stronie.
HardMarginY	Pobiera współrzędną y w setnych częściach cala z twardego marginesu w górnej części strony.
Landscape	Pobiera lub ustawia wartość wskazującą, czy strona jest drukowana w orientacji poziomej, czy pionowej.
Margins	Pobiera lub ustawia marginesy dla tej strony.
PaperSize	Pobiera lub ustawia rozmiar papieru dla strony.
PaperSource	Pobiera lub ustawia źródło papieru strony; na przykład górny zasobnik drukarki.
PrintableArea	Pobiera granice obszaru drukowania strony dla drukarki.
PrinterResolution	Pobiera lub ustawia rozdzielczość drukarki dla strony.
PrinterSettings	Pobiera lub ustawia ustawienia drukarki skojarzone ze stroną.

Metody

Clone()	Tworzy kopię tego elementu PageSettings.
CopyToHdevmode(IntPtr)	Kopiuje odpowiednie informacje z obiektu PageSettings do określonej DEVMODE struktury.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
SetHdevmode(IntPtr)	Kopiuje odpowiednie informacje do PageSettings obiektu z określonej DEVMODE struktury.
ToString()	Konwertuje formularz PageSettings na ciąg.

Zobacz też

• PrintDocument
• PrinterSettings