PageSettings Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Określa ustawienia, które mają zastosowanie do jednej, drukowanej strony.
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
- Dziedziczenie
-
PageSettings
- Atrybuty
- Implementuje
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 |
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 |
ToString() |
Konwertuje formularz PageSettings na ciąg. |