PrinterSettings PrinterSettings PrinterSettings PrinterSettings Class

Definicja

Określa informacje o sposobie drukowania dokumentu, włącznie z drukarką, która drukuje podczas drukowania z aplikacji Windows Forms.Specifies information about how a document is printed, including the printer that prints it, when printing from a Windows Forms application.

public ref class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
type PrinterSettings = class
    interface ICloneable
Public Class PrinterSettings
Implements ICloneable
Dziedziczenie
PrinterSettingsPrinterSettingsPrinterSettingsPrinterSettings
Atrybuty
Implementuje

Przykłady

Poniższy przykład kodu drukuje dokument na określonej drukarce.The following code example prints a document on the specified printer. Przykład ma trzy wymagania wstępne:The example has three prerequisites:

  • Zmienna o nazwie filePath została ustawiona na ścieżkę pliku do wydrukowania.A variable named filePath has been set to the path of the file to print.

  • Zdefiniowano metodę pd_PrintPageo nazwie, która PrintPage obsługuje zdarzenie.A method named pd_PrintPage, which handles the PrintPage event, has been defined.

  • Zmienna o nazwie printer została ustawiona na nazwę drukarki.A variable named printer has been set to the printer's name.

W tym przykładzie System.Drawing.Printingnależy użyć System.IO przestrzeni nazw ,i.System.DrawingUse the System.Drawing, System.Drawing.Printing, and System.IO namespaces for this example.

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 dostęp PrinterSettings PageSettings.PrinterSettings do programu PrintDocument.PrinterSettings lub właściwości można zmienić, aby zmodyfikować ustawienia drukarki.Typically, you access a PrinterSettings through PrintDocument.PrinterSettings or PageSettings.PrinterSettings properties to modify printer settings. Najbardziej typowym ustawieniem drukarki PrinterNamejest, które określa drukarkę do drukowania.The most common printer setting is PrinterName, which specifies the printer to print to.

Aby uzyskać więcej informacji o drukowaniu z Windows Forms, System.Drawing.Printing Zobacz Omówienie przestrzeni nazw.For more information about printing with Windows Forms, see the System.Drawing.Printing namespace overview. Jeśli chcesz drukować z aplikacji Windows Presentation Foundation, zobacz System.Printing przestrzeń nazw.If you wish to print from a Windows Presentation Foundation application, see the System.Printing namespace.

Konstruktory

PrinterSettings() PrinterSettings() PrinterSettings() PrinterSettings()

Inicjuje nowe wystąpienie klasy PrinterSettings klasy.Initializes a new instance of the PrinterSettings class.

Właściwości

CanDuplex CanDuplex CanDuplex CanDuplex

Pobiera wartość wskazującą, czy drukarka obsługuje drukowanie dwustronne.Gets a value indicating whether the printer supports double-sided printing.

Collate Collate Collate Collate

Pobiera lub ustawia wartość wskazującą, czy drukowany dokument jest sortowany.Gets or sets a value indicating whether the printed document is collated.

Copies Copies Copies Copies

Pobiera lub ustawia liczbę kopii dokumentu do wydrukowania.Gets or sets the number of copies of the document to print.

DefaultPageSettings DefaultPageSettings DefaultPageSettings DefaultPageSettings

Pobiera domyślne ustawienia strony dla tej drukarki.Gets the default page settings for this printer.

Duplex Duplex Duplex Duplex

Pobiera lub ustawia ustawienie drukarki na potrzeby drukowania dwustronnego.Gets or sets the printer setting for double-sided printing.

FromPage FromPage FromPage FromPage

Pobiera lub ustawia numer strony pierwszej strony do wydrukowania.Gets or sets the page number of the first page to print.

InstalledPrinters InstalledPrinters InstalledPrinters InstalledPrinters

Pobiera nazwy wszystkich drukarek zainstalowanych na komputerze.Gets the names of all printers installed on the computer.

IsDefaultPrinter IsDefaultPrinter IsDefaultPrinter IsDefaultPrinter

Pobiera wartość wskazującą, czy PrinterName Właściwość wyznacza drukarkę domyślną, z wyjątkiem sytuacji, w której użytkownik jawnie ustawia. PrinterNameGets a value indicating whether the PrinterName property designates the default printer, except when the user explicitly sets PrinterName.

IsPlotter IsPlotter IsPlotter IsPlotter

Pobiera wartość wskazującą, czy drukarka jest ploterem.Gets a value indicating whether the printer is a plotter.

IsValid IsValid IsValid IsValid

Pobiera wartość wskazującą, czy PrinterName Właściwość wyznacza prawidłową drukarkę.Gets a value indicating whether the PrinterName property designates a valid printer.

LandscapeAngle LandscapeAngle LandscapeAngle LandscapeAngle

Pobiera kąt (w stopniach), w którym orientacja pionowa jest obracana w celu uzyskania orientacji poziomej.Gets the angle, in degrees, that the portrait orientation is rotated to produce the landscape orientation.

MaximumCopies MaximumCopies MaximumCopies MaximumCopies

Pobiera maksymalną liczbę kopii, jaką Drukarka umożliwia użytkownikowi drukowanie jednocześnie.Gets the maximum number of copies that the printer enables the user to print at a time.

MaximumPage MaximumPage MaximumPage MaximumPage

Pobiera lub ustawia wartość maksymalną FromPage lub ToPage , którą PrintDialogmożna wybrać w.Gets or sets the maximum FromPage or ToPage that can be selected in a PrintDialog.

MinimumPage MinimumPage MinimumPage MinimumPage

Pobiera lub ustawia wartość FromPage minimalną ToPage lub PrintDialogmożna ją wybrać w.Gets or sets the minimum FromPage or ToPage that can be selected in a PrintDialog.

PaperSizes PaperSizes PaperSizes PaperSizes

Pobiera rozmiary papieru, które są obsługiwane przez tę drukarkę.Gets the paper sizes that are supported by this printer.

PaperSources PaperSources PaperSources PaperSources

Pobiera zasobniki źródła papieru, które są dostępne na drukarce.Gets the paper source trays that are available on the printer.

PrinterName PrinterName PrinterName PrinterName

Pobiera lub ustawia nazwę drukarki do użycia.Gets or sets the name of the printer to use.

PrinterResolutions PrinterResolutions PrinterResolutions PrinterResolutions

Pobiera wszystkie rozdzielczości obsługiwane przez tę drukarkę.Gets all the resolutions that are supported by this printer.

PrintFileName PrintFileName PrintFileName PrintFileName

Pobiera lub ustawia nazwę pliku podczas drukowania do pliku.Gets or sets the file name, when printing to a file.

PrintRange PrintRange PrintRange PrintRange

Pobiera lub ustawia numery stron określone przez użytkownika do wydrukowania.Gets or sets the page numbers that the user has specified to be printed.

PrintToFile PrintToFile PrintToFile PrintToFile

Pobiera lub ustawia wartość wskazującą, czy dane wyjściowe drukowania są wysyłane do pliku, a nie do portu.Gets or sets a value indicating whether the printing output is sent to a file instead of a port.

SupportsColor SupportsColor SupportsColor SupportsColor

Pobiera wartość wskazującą, czy ta drukarka obsługuje drukowanie w kolorze.Gets a value indicating whether this printer supports color printing.

ToPage ToPage ToPage ToPage

Pobiera lub ustawia numer ostatniej strony do wydrukowania.Gets or sets the number of the last page to print.

Metody

Clone() Clone() Clone() Clone()

Tworzy kopię tego PrinterSettingselementu.Creates a copy of this PrinterSettings.

CreateMeasurementGraphics() CreateMeasurementGraphics() CreateMeasurementGraphics() CreateMeasurementGraphics()

Zwraca zawierający informacje o drukarkach, które są przydatne podczas PrintDocumenttworzenia. GraphicsReturns a Graphics that contains printer information that is useful when creating a PrintDocument.

CreateMeasurementGraphics(Boolean) CreateMeasurementGraphics(Boolean) CreateMeasurementGraphics(Boolean) CreateMeasurementGraphics(Boolean)

Zwraca, Graphics który zawiera informacje o drukarce, opcjonalnie określając źródło na marginesie.Returns a Graphics that contains printer information, optionally specifying the origin at the margins.

CreateMeasurementGraphics(PageSettings) CreateMeasurementGraphics(PageSettings) CreateMeasurementGraphics(PageSettings) CreateMeasurementGraphics(PageSettings)

Zwraca element Graphics zawierający informacje o drukarce skojarzone z określonym PageSettings.Returns a Graphics that contains printer information associated with the specified PageSettings.

CreateMeasurementGraphics(PageSettings, Boolean) CreateMeasurementGraphics(PageSettings, Boolean) CreateMeasurementGraphics(PageSettings, Boolean) CreateMeasurementGraphics(PageSettings, Boolean)

Graphics Tworzy skojarzenie z określonymi ustawieniami strony i opcjonalnie określa źródło na marginesie.Creates a Graphics associated with the specified page settings and optionally specifying the origin at the margins.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Inherited from Object)
GetHdevmode() GetHdevmode() GetHdevmode() GetHdevmode()

Tworzy dojście do DEVMODE struktury, która odpowiada ustawieniom drukarki.Creates a handle to a DEVMODE structure that corresponds to the printer settings.

GetHdevmode(PageSettings) GetHdevmode(PageSettings) GetHdevmode(PageSettings) GetHdevmode(PageSettings)

Tworzy dojście do DEVMODE struktury zgodnej z drukarką oraz ustawienia strony określone pageSettings za pomocą parametru.Creates a handle to a DEVMODE structure that corresponds to the printer and the page settings specified through the pageSettings parameter.

GetHdevnames() GetHdevnames() GetHdevnames() GetHdevnames()

Tworzy dojście do DEVNAMES struktury, która odpowiada ustawieniom drukarki.Creates a handle to a DEVNAMES structure that corresponds to the printer settings.

GetType() GetType() GetType() GetType()

Type Pobiera bieżące wystąpienie.Gets the Type of the current instance.

(Inherited from Object)
IsDirectPrintingSupported(Image) IsDirectPrintingSupported(Image) IsDirectPrintingSupported(Image) IsDirectPrintingSupported(Image)

Pobiera wartość wskazującą, czy drukarka obsługuje drukowanie określonego pliku obrazu.Gets a value indicating whether the printer supports printing the specified image file.

IsDirectPrintingSupported(ImageFormat) IsDirectPrintingSupported(ImageFormat) IsDirectPrintingSupported(ImageFormat) IsDirectPrintingSupported(ImageFormat)

Zwraca wartość wskazującą, czy drukarka obsługuje drukowanie określonego formatu obrazu.Returns a value indicating whether the printer supports printing the specified image format.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Tworzy skróconą kopię bieżącego Objectelementu.Creates a shallow copy of the current Object.

(Inherited from Object)
SetHdevmode(IntPtr) SetHdevmode(IntPtr) SetHdevmode(IntPtr) SetHdevmode(IntPtr)

Kopiuje istotne informacje z danego uchwytu i do PrinterSettings.Copies the relevant information out of the given handle and into the PrinterSettings.

SetHdevnames(IntPtr) SetHdevnames(IntPtr) SetHdevnames(IntPtr) SetHdevnames(IntPtr)

Kopiuje istotne informacje z danego uchwytu i do PrinterSettings.Copies the relevant information out of the given handle and into the PrinterSettings.

ToString() ToString() ToString() ToString()

Zawiera informacje o PrinterSettings formularzu w postaci ciągu.Provides information about the PrinterSettings in string form.

Dotyczy

Zobacz też