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, drukowanej 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 PageSettings służy do określania ustawień, które modyfikują sposób drukowania strony. Zazwyczaj ustawiasz 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, obsłuż PrintDocument.PrintPage zdarzenie lub PrintDocument.QueryPageSettings i zmodyfikuj PageSettings argument uwzględniony odpowiednio w elemecie PrintPageEventArgs lub .QueryPageSettingsEventArgs

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

Uwaga

W programach .NET 6 i nowszych pakiet System.Drawing.Common, który zawiera 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, uwzględniając orientację strony określoną przez Landscape właściwość.
Color	Pobiera lub ustawia wartość wskazującą, czy strona powinna być wydrukowana w kolorze.
HardMarginX	Pobiera współrzędną x w setkach cala z twardego marginesu po lewej stronie.
HardMarginY	Pobiera współrzędną y w setkach cala na twardym marginesie u góry 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órna taca 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 PageSettings 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 bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
SetHdevmode(IntPtr)	Kopiuje odpowiednie informacje do PageSettings elementu z określonej DEVMODE struktury.
ToString()	Konwertuje formularz PageSettings na ciąg.

Zobacz też

• PrintDocument
• PrinterSettings