PrinterSettings Klasa

Definicja

Przestrzeń nazw:

System.Drawing.Printing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

PrinterSettings.cs

Określa informacje o sposobie drukowania dokumentu, w tym drukarki, która ją 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. W przykładzie przedstawiono 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 za PageSettings.PrinterSettings pośrednictwemPrintDocument.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ą Windows Forms, zobacz System.Drawing.Printing omówienie przestrzeni nazw. Jeśli chcesz wydrukować z aplikacji Windows Presentation Foundation, zobacz System.Printing przestrzeń 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

PrinterSettings()

Inicjuje nowe wystąpienie klasy PrinterSettings.

Właściwości

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 PrinterNamewartość .
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 wygenerowania 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 rozwiązania obsługiwane przez tę drukarkę.
PrintFileName	Pobiera lub ustawia nazwę pliku podczas drukowania w pliku.
PrintRange	Pobiera lub ustawia numery stron określone przez użytkownika 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

Clone()	Tworzy kopię tego elementu PrinterSettings.
CreateMeasurementGraphics()	Zwraca element Graphics zawierający informacje o drukarce, które są przydatne podczas tworzenia elementu PrintDocument.
CreateMeasurementGraphics(Boolean)	Graphics Zwraca element zawierający informacje o drukarce, opcjonalnie określając źródło na marginesach.
CreateMeasurementGraphics(PageSettings)	Zwraca element Graphics zawierający informacje o drukarce skojarzone z określonym PageSettingselementem .
CreateMeasurementGraphics(PageSettings, Boolean)	Graphics Tworzy skojarzony z określonymi ustawieniami strony i opcjonalnie określając źródło na marginesach.
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)
GetHdevmode()	Tworzy uchwyt do DEVMODE struktury odpowiadającej ustawieniam drukarki.
GetHdevmode(PageSettings)	Tworzy uchwyt do DEVMODE struktury odpowiadającej drukarce i ustawień strony określonych za pomocą parametru pageSettings .
GetHdevnames()	Tworzy uchwyt do DEVNAMES struktury odpowiadającej ustawieniam drukarki.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
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.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
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 ciągu.

Zobacz też

• PrinterName
• PrinterSettings
• PrinterSettings