PrinterSettings Klasa

Definicja

Przestrzeń nazw:

System.Drawing.Printing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v11.0.0-preview.4.26230.115

Źródło:

PrinterSettings.cs

Określa informacje o sposobie drukowania dokumentu, w tym drukarki, która go drukuje, podczas drukowania z aplikacji Windows Forms.

public ref class PrinterSettings : ICloneable

public class PrinterSettings : ICloneable

type PrinterSettings = class
    interface ICloneable

Public Class PrinterSettings
Implements ICloneable

Dziedziczenie

Object

PrinterSettings

Implementuje

ICloneable

Przykłady

Poniższy przykład kodu drukuje dokument na określonej drukarce. Przykład ma trzy wymagania wstępne:

• Zmienna o nazwie filePath została ustawiona na ścieżkę pliku do wydrukowania.

• Zdefiniowano metodę o nazwie pd_PrintPage, która obsługuje PrintPage zdarzenie.

• Zmienna o nazwie printer została ustawiona na nazwę drukarki.

W tym przykładzie System.Drawingużyj przestrzeni nazw , System.Drawing.Printingi System.IO .

public:
   void Printing( String^ printer )
   {
      try
      {
         streamToPrint = gcnew StreamReader( filePath );
         try
         {
            printFont = gcnew System::Drawing::Font( "Arial",10 );
            PrintDocument^ pd = gcnew PrintDocument;
            pd->PrintPage += gcnew PrintPageEventHandler(
               this, &Form1::pd_PrintPage );
            // Specify the printer to use.
            pd->PrinterSettings->PrinterName = printer;
            if ( pd->PrinterSettings->IsValid )
            {
               pd->Print();
            }
            else
            {
               MessageBox::Show( "Printer is invalid." );
            }
         }
         finally
         {
            streamToPrint->Close();
         }
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( ex->Message );
      }
   }

public void Printing(string printer) {
  try {
    streamToPrint = new StreamReader (filePath);
    try {
      printFont = new Font("Arial", 10);
      PrintDocument pd = new PrintDocument(); 
      pd.PrintPage += new PrintPageEventHandler(pd_PrintPage);
      // Specify the printer to use.
      pd.PrinterSettings.PrinterName = printer;

      if (pd.PrinterSettings.IsValid) {
         pd.Print();
      } 
      else {	
         MessageBox.Show("Printer is invalid.");
      }
    } 
    finally {
      streamToPrint.Close();
    }
  } 
  catch(Exception ex) {
    MessageBox.Show(ex.Message);
  }
}

Public Sub Printing(printer As String)
    Try
        streamToPrint = New StreamReader(filePath)
        Try
            printFont = New Font("Arial", 10)
            Dim pd As New PrintDocument()
            AddHandler pd.PrintPage, AddressOf pd_PrintPage
            ' Specify the printer to use.
            pd.PrinterSettings.PrinterName = printer

            If pd.PrinterSettings.IsValid then
               pd.Print()
            Else
               MessageBox.Show("Printer is invalid.")
            End If
        Finally
            streamToPrint.Close()
        End Try
    Catch ex As Exception
        MessageBox.Show(ex.Message)
    End Try
End Sub

Uwagi

Zazwyczaj uzyskujesz dostęp do PrinterSettings właściwości lub PrintDocument.PrinterSettings za pośrednictwemPageSettings.PrinterSettings, aby zmodyfikować ustawienia drukarki. Najczęstszym ustawieniem drukarki jest PrinterName, który określa drukarkę do drukowania.

Aby uzyskać więcej informacji na temat drukowania za pomocą formularzy systemu Windows, zobacz System.Drawing.Printing omówienie przestrzeni nazw. Jeśli chcesz wydrukować z aplikacji Windows Presentation Foundation, zobacz System.Printing przestrzeń nazw.

Note

W wersjach .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 supported only on Windows (Obsługiwane tylko w systemie Windows).

Konstruktory

Nazwa	Opis
PrinterSettings()	Inicjuje nowe wystąpienie klasy PrinterSettings.

Właściwości

Nazwa	Opis
CanDuplex	Pobiera wartość wskazującą, czy drukarka obsługuje drukowanie dwustronne.
Collate	Pobiera lub ustawia wartość wskazującą, czy wydrukowany dokument jest sortowany.
Copies	Pobiera lub ustawia liczbę kopii dokumentu do wydrukowania.
DefaultPageSettings	Pobiera domyślne ustawienia strony dla tej drukarki.
Duplex	Pobiera lub ustawia ustawienie drukarki na potrzeby drukowania dwustronnego.
FromPage	Pobiera lub ustawia numer strony pierwszej strony do wydrukowania.
InstalledPrinters	Pobiera nazwy wszystkich drukarek zainstalowanych na komputerze.
IsDefaultPrinter	Pobiera wartość wskazującą, czy PrinterName właściwość wyznacza drukarkę domyślną, z wyjątkiem sytuacji, gdy użytkownik jawnie ustawia wartość PrinterName.
IsPlotter	Pobiera wartość wskazującą, czy drukarka jest ploterem.
IsValid	Pobiera wartość wskazującą, czy PrinterName właściwość wyznacza prawidłową drukarkę.
LandscapeAngle	Pobiera kąt w stopniach, że orientacja pionowa jest obracana w celu uzyskania orientacji poziomej.
MaximumCopies	Pobiera maksymalną liczbę kopii, które drukarka umożliwia użytkownikowi drukowanie naraz.
MaximumPage	Pobiera lub ustawia wartość maksymalną FromPage lub ToPage którą można wybrać w elemecie PrintDialog.
MinimumPage	Pobiera lub ustawia wartość minimalną FromPage lub ToPage którą można wybrać w elemecie PrintDialog.
PaperSizes	Pobiera rozmiary papieru obsługiwane przez tę drukarkę.
PaperSources	Pobiera zasobniki źródła papieru, które są dostępne na drukarce.
PrinterName	Pobiera lub ustawia nazwę drukarki do użycia.
PrinterResolutions	Pobiera wszystkie rozdzielczości obsługiwane przez tę drukarkę.
PrintFileName	Pobiera lub ustawia nazwę pliku podczas drukowania w pliku.
PrintRange	Pobiera lub ustawia numery stron, które użytkownik określił do wydrukowania.
PrintToFile	Pobiera lub ustawia wartość wskazującą, czy dane wyjściowe drukowania są wysyłane do pliku zamiast portu.
SupportsColor	Pobiera wartość wskazującą, czy ta drukarka obsługuje drukowanie kolorów.
ToPage	Pobiera lub ustawia liczbę ostatniej strony do wydrukowania.

Metody

Nazwa	Opis
Clone()	Tworzy kopię tego elementu PrinterSettings.
CreateMeasurementGraphics()	Zwraca obiekt Graphics zawierający informacje o drukarce, które są przydatne podczas tworzenia obiektu PrintDocument.
CreateMeasurementGraphics(Boolean)	Zwraca obiekt Graphics zawierający informacje o drukarce, opcjonalnie określając źródło na marginesach.
CreateMeasurementGraphics(PageSettings, Boolean)	Graphics Tworzy element skojarzony z określonymi ustawieniami strony i opcjonalnie określa źródło na marginesach.
CreateMeasurementGraphics(PageSettings)	Zwraca obiekt Graphics zawierający informacje o drukarce skojarzone z określonym PageSettingselementem .
GetHdevmode()	Tworzy uchwyt do DEVMODE struktury odpowiadającej ustawieniam drukarki.
GetHdevmode(PageSettings)	Tworzy uchwyt do DEVMODE struktury odpowiadającej drukarki i ustawień strony określonych za pomocą parametru pageSettings .
GetHdevnames()	Tworzy uchwyt do DEVNAMES struktury odpowiadającej ustawieniam drukarki.
IsDirectPrintingSupported(Image)	Pobiera wartość wskazującą, czy drukarka obsługuje drukowanie określonego pliku obrazu.
IsDirectPrintingSupported(ImageFormat)	Zwraca wartość wskazującą, czy drukarka obsługuje drukowanie określonego formatu obrazu.
SetHdevmode(IntPtr)	Kopiuje odpowiednie informacje z danego uchwytu i do .PrinterSettings
SetHdevnames(IntPtr)	Kopiuje odpowiednie informacje z danego uchwytu i do .PrinterSettings
ToString()	Zawiera informacje o formularzu PrinterSettings w ciągu.

Zobacz też

• PrinterName
• PrinterSettings
• PrinterSettings