PrinterSettings Klass

Definition

Anger information om hur ett dokument skrivs ut, inklusive den skrivare som skriver ut det, när det skrivs ut från ett Windows Forms program.

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
Arv
PrinterSettings
Attribut
Implementeringar

Exempel

I följande kodexempel skrivs ett dokument ut på den angivna skrivaren. Exemplet har tre förutsättningar:

  • En variabel med namnet filePath har angetts till sökvägen till filen som ska skrivas ut.

  • En metod med namnet pd_PrintPage, som hanterar PrintPage händelsen, har definierats.

  • En variabel med namnet printer har angetts till skrivarens namn.

System.DrawingAnvänd namnrymderna , System.Drawing.Printingoch System.IO för det här exemplet.

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

Kommentarer

Vanligtvis får du åtkomst till en PrinterSettings genom PrintDocument.PrinterSettings - eller PageSettings.PrinterSettings -egenskaper för att ändra skrivarinställningarna. Den vanligaste skrivarinställningen är PrinterName, som anger vilken skrivare som ska skrivas ut till.

Mer information om hur du skriver ut med Windows Forms finns i översikten System.Drawing.Printing namnområde. Om du vill skriva ut från ett Windows Presentation Foundation program läser du namnområdet System.Printing.

Note

I .NET 6 och senare versioner stöds endast System.Drawing.Common-paketet, som innehåller den här typen, på Windows-operativsystem. Användning av den här typen i plattformsoberoende appar orsakar kompileringstidsvarningar och körningsfel. Mer information finns i System.Drawing.Common som endast stöds i Windows.

Konstruktorer

Name Description
PrinterSettings()

Initierar en ny instans av PrinterSettings klassen.

Egenskaper

Name Description
CanDuplex

Hämtar ett värde som anger om skrivaren stöder dubbelsidig utskrift.

Collate

Hämtar eller anger ett värde som anger om det utskrivna dokumentet är sorterat.

Copies

Hämtar eller anger hur många kopior av dokumentet som ska skrivas ut.

DefaultPageSettings

Hämtar standardsidans inställningar för den här skrivaren.

Duplex

Hämtar eller ställer in skrivarinställningen för dubbelsidig utskrift.

FromPage

Hämtar eller anger sidnumret för den första sidan som ska skrivas ut.

InstalledPrinters

Hämtar namnen på alla skrivare som är installerade på datorn.

IsDefaultPrinter

Hämtar ett värde som anger om PrinterName egenskapen anger standardskrivaren, förutom när användaren uttryckligen anger PrinterName.

IsPlotter

Hämtar ett värde som anger om skrivaren är en plotter.

IsValid

Hämtar ett värde som anger om egenskapen PrinterName anger en giltig skrivare.

LandscapeAngle

Hämtar vinkeln, i grader, att stående orientering roteras för att producera liggande orientering.

MaximumCopies

Hämtar det maximala antalet kopior som skrivaren gör att användaren kan skriva ut åt gången.

MaximumPage

Hämtar eller anger maximalt FromPage eller ToPage som kan väljas i en PrintDialog.

MinimumPage

Hämtar eller anger minimivärdet FromPage eller ToPage som kan väljas i en PrintDialog.

PaperSizes

Hämtar de pappersstorlekar som stöds av den här skrivaren.

PaperSources

Hämtar papperskällans fack som är tillgängliga på skrivaren.

PrinterName

Hämtar eller anger namnet på skrivaren som ska användas.

PrinterResolutions

Hämtar alla upplösningar som stöds av den här skrivaren.

PrintFileName

Hämtar eller anger filnamnet när du skriver ut till en fil.

PrintRange

Hämtar eller anger de sidnummer som användaren har angett som ska skrivas ut.

PrintToFile

Hämtar eller anger ett värde som anger om utskriftsutdata skickas till en fil i stället för en port.

SupportsColor

Hämtar ett värde som anger om den här skrivaren stöder färgutskrift.

ToPage

Hämtar eller anger numret på den sista sidan som ska skrivas ut.

Metoder

Name Description
Clone()

Skapar en kopia av den här PrinterSettings.

CreateMeasurementGraphics()

Returnerar en Graphics som innehåller skrivarinformation som är användbar när du skapar en PrintDocument.

CreateMeasurementGraphics(Boolean)

Returnerar en Graphics som innehåller skrivarinformation, om du vill ange ursprunget vid marginalerna.

CreateMeasurementGraphics(PageSettings, Boolean)

Skapar en Graphics associerad med de angivna sidinställningarna och kan också ange ursprunget vid marginalerna.

CreateMeasurementGraphics(PageSettings)

Returnerar en Graphics som innehåller skrivarinformation som är associerad med angiven PageSettings.

Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetHdevmode()

Skapar ett handtag till en DEVMODE struktur som motsvarar skrivarinställningarna.

GetHdevmode(PageSettings)

Skapar ett handtag till en DEVMODE struktur som motsvarar skrivaren och sidinställningarna som anges via parametern pageSettings .

GetHdevnames()

Skapar ett handtag till en DEVNAMES struktur som motsvarar skrivarinställningarna.

GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
IsDirectPrintingSupported(Image)

Hämtar ett värde som anger om skrivaren stöder utskrift av den angivna bildfilen.

IsDirectPrintingSupported(ImageFormat)

Returnerar ett värde som anger om skrivaren stöder utskrift av det angivna bildformatet.

MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
SetHdevmode(IntPtr)

Kopierar relevant information från det angivna handtaget och till PrinterSettings.

SetHdevnames(IntPtr)

Kopierar relevant information från det angivna handtaget och till PrinterSettings.

ToString()

Innehåller information om PrinterSettings i strängformuläret.

Gäller för

Se även