Udostępnij za pośrednictwem


PrinterSettings Klasa

Definicja

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
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
[System.Serializable]
public class PrinterSettings : ICloneable
type PrinterSettings = class
    interface ICloneable
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Serializable>]
type PrinterSettings = class
    interface ICloneable
[<System.Serializable>]
type PrinterSettings = class
    interface ICloneable
Public Class PrinterSettings
Implements ICloneable
Dziedziczenie
PrinterSettings
Atrybuty
Implementuje

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 drukowania.

  • 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 dostęp do właściwości lub PrintDocument.PrinterSettingsPageSettings.PrinterSettings można uzyskać PrinterSettings w celu zmodyfikowania ustawień 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 programie .NET 6 i nowszych wersjach pakiet System.Drawing.Common, który obejmuje 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 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 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 numer ostatniej strony do wydrukowania.

Metody

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)

Zwraca obiekt Graphics zawierający informacje o drukarce skojarzone z określonym PageSettingselementem .

CreateMeasurementGraphics(PageSettings, Boolean)

Tworzy obiekt Graphics skojarzony z określonymi ustawieniami strony i opcjonalnie określa ź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 dojście do DEVMODE struktury odpowiadającej ustawieniu drukarki.

GetHdevmode(PageSettings)

Tworzy uchwyt do DEVMODE struktury odpowiadającej drukarce i ustawień strony określonych za pomocą parametru pageSettings .

GetHdevnames()

Tworzy dojście do DEVNAMES struktury odpowiadającej ustawieniu drukarki.

GetType()

Type Pobiera wartość bieżącego wystąpienia.

(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 w ciągu.

Dotyczy

Zobacz też