PrinterSettings Klas

Definitie

Hiermee geeft u informatie op over hoe een document wordt afgedrukt, inclusief de printer die het document afdrukt, wanneer u afdrukt vanuit een Windows Forms toepassing.

public ref class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
[System.Serializable]
public class PrinterSettings : 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
Overname
PrinterSettings
Kenmerken
Implementeringen

Voorbeelden

In het volgende codevoorbeeld wordt een document afgedrukt op de opgegeven printer. Het voorbeeld heeft drie vereisten:

  • Er is een variabele met de naam filePath ingesteld op het pad van het bestand dat moet worden afgedrukt.

  • Er is een methode met de naam pd_PrintPage, die de PrintPage gebeurtenis afhandelt, gedefinieerd.

  • Er is een variabele met de naam printer van de printer ingesteld.

Gebruik de System.Drawing, System.Drawing.Printingen System.IO naamruimten voor dit voorbeeld.

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

Opmerkingen

Normaal gesproken opent u een PrinterSettings of meer PageSettings.PrinterSettingsPrintDocument.PrinterSettings eigenschappen om printerinstellingen te wijzigen. De meest voorkomende printerinstelling is PrinterName, waarmee de printer wordt opgegeven waarnaar moet worden afgedrukt.

Zie het overzicht System.Drawing.Printing naamruimte voor meer informatie over afdrukken met Windows Forms. Als u wilt afdrukken vanuit een Windows Presentation Foundation toepassing, raadpleegt u de System.Printing naamruimte.

Note

In .NET 6 en latere versies wordt het pakket System.Drawing.Common, dat dit type bevat, alleen ondersteund op Windows-besturingssystemen. Het gebruik van dit type in platformoverschrijdende apps veroorzaakt compileertijdwaarschuwingen en runtime-uitzonderingen. Zie System.Drawing.Common alleen ondersteund in Windows voor meer informatie.

Constructors

Name Description
PrinterSettings()

Initialiseert een nieuw exemplaar van de PrinterSettings klasse.

Eigenschappen

Name Description
CanDuplex

Hiermee wordt een waarde opgehaald die aangeeft of de printer dubbelzijdig afdrukken ondersteunt.

Collate

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het afgedrukte document is gesorteerd.

Copies

Hiermee kunt u het aantal exemplaren van het document ophalen of instellen dat moet worden afgedrukt.

DefaultPageSettings

Hiermee haalt u de standaardpagina-instellingen voor deze printer op.

Duplex

Hiermee wordt de printerinstelling opgehaald of ingesteld voor dubbelzijdig afdrukken.

FromPage

Hiermee haalt u het paginanummer van de eerste pagina op of stelt u deze in om af te drukken.

InstalledPrinters

Hiermee haalt u de namen op van alle printers die op de computer zijn geïnstalleerd.

IsDefaultPrinter

Hiermee wordt een waarde opgehaald die aangeeft of de PrinterName eigenschap de standaardprinter aanwijst, behalve wanneer de gebruiker expliciet instelt PrinterName.

IsPlotter

Hiermee wordt een waarde opgehaald die aangeeft of de printer een plotter is.

IsValid

Hiermee wordt een waarde opgehaald die aangeeft of de PrinterName eigenschap een geldige printer aanwijst.

LandscapeAngle

Hiermee haalt u de hoek op, in graden, dat de staande stand wordt gedraaid om de liggende stand te produceren.

MaximumCopies

Hiermee haalt u het maximum aantal exemplaren op dat de printer de gebruiker in staat stelt om tegelijk af te drukken.

MaximumPage

Hiermee haalt u het maximum op of stelt u het maximum FromPage in of ToPage dat kan worden geselecteerd in een PrintDialog.

MinimumPage

Hiermee haalt u het minimum op of stelt u het minimum FromPage in of ToPage dat kan worden geselecteerd in een PrintDialog.

PaperSizes

Hiermee haalt u de papierformaten op die door deze printer worden ondersteund.

PaperSources

Hiermee haalt u de papierbronlades op die beschikbaar zijn op de printer.

PrinterName

Hiermee haalt u de naam van de printer op of stelt u deze in.

PrinterResolutions

Hiermee haalt u alle resoluties op die door deze printer worden ondersteund.

PrintFileName

Hiermee haalt u de bestandsnaam op of stelt u deze in wanneer u afdrukt naar een bestand.

PrintRange

Hiermee haalt u de paginanummers op die de gebruiker heeft opgegeven om af te drukken.

PrintToFile

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de afdrukuitvoer naar een bestand wordt verzonden in plaats van een poort.

SupportsColor

Hiermee wordt een waarde opgehaald die aangeeft of deze printer kleurenafdruk ondersteunt.

ToPage

Hiermee kunt u het nummer van de laatste pagina ophalen of instellen om af te drukken.

Methoden

Name Description
Clone()

Hiermee maakt u een kopie van deze PrinterSettings.

CreateMeasurementGraphics()

Retourneert een Graphics die printerinformatie bevat die handig is bij het maken van een PrintDocument.

CreateMeasurementGraphics(Boolean)

Retourneert een Graphics met printergegevens, eventueel de oorsprong aan de marges opgeven.

CreateMeasurementGraphics(PageSettings, Boolean)

Hiermee maakt u een Graphics gekoppeld aan de opgegeven pagina-instellingen en geeft u desgewenst de oorsprong aan de marges op.

CreateMeasurementGraphics(PageSettings)

Retourneert een Graphics met printergegevens die zijn gekoppeld aan de opgegeven PageSettings.

Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetHdevmode()

Hiermee maakt u een ingang naar een DEVMODE structuur die overeenkomt met de printerinstellingen.

GetHdevmode(PageSettings)

Hiermee maakt u een ingang voor een DEVMODE structuur die overeenkomt met de printer en de pagina-instellingen die zijn opgegeven via de pageSettings parameter.

GetHdevnames()

Hiermee maakt u een ingang naar een DEVNAMES structuur die overeenkomt met de printerinstellingen.

GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
IsDirectPrintingSupported(Image)

Hiermee wordt een waarde opgehaald die aangeeft of de printer het afdrukken van het opgegeven afbeeldingsbestand ondersteunt.

IsDirectPrintingSupported(ImageFormat)

Retourneert een waarde die aangeeft of de printer het afdrukken van de opgegeven afbeeldingsindeling ondersteunt.

MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
SetHdevmode(IntPtr)

Kopieert de relevante informatie uit de opgegeven ingang en naar de PrinterSettings.

SetHdevnames(IntPtr)

Kopieert de relevante informatie uit de opgegeven ingang en naar de PrinterSettings.

ToString()

Bevat informatie over het PrinterSettings in tekenreeksformulier.

Van toepassing op

Zie ook