PrinterSettings Classe

Definizione

Spazio dei nomi:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

PrinterSettings.cs

Specifica informazioni sulle modalità con cui viene stampato un documento, inclusa la stampante che lo stampa, in caso di stampa da un'applicazione Windows Forms.

public ref class PrinterSettings : ICloneable

public class PrinterSettings : ICloneable

type PrinterSettings = class
    interface ICloneable

Public Class PrinterSettings
Implements ICloneable

Ereditarietà

Object

PrinterSettings

Implementazioni

ICloneable

Esempio

Nell'esempio di codice seguente viene stampato un documento sulla stampante specificata. L'esempio presenta tre prerequisiti:

• È stata impostata una variabile denominata filePath sul percorso del file da stampare.

• È stato definito un metodo denominato pd_PrintPage, che gestisce l'evento PrintPage .

• Una variabile denominata printer è stata impostata sul nome della stampante.

Usare gli spazi dei System.Drawingnomi , System.Drawing.Printinge System.IO per questo esempio.

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

Commenti

In genere, si accede a un PrinterSettings tramite PrintDocument.PrinterSettings o PageSettings.PrinterSettings proprietà per modificare le impostazioni della stampante. L'impostazione della stampante più comune è PrinterName, che specifica la stampante in cui stampare.

Per altre informazioni sulla stampa con Windows Forms, vedere la panoramica dello System.Drawing.Printing spazio dei nomi. Per stampare da un'applicazione Windows Presentation Foundation, vedere lo spazio dei System.Printing nomi .

Nota

In .NET 6 e versioni successive, il pacchetto System.Drawing.Common, che include questo tipo, è supportato solo nei sistemi operativi Windows. L'uso di questo tipo nelle app multipiattaforma causa avvisi in fase di compilazione ed eccezioni di runtime. Per altre informazioni, vedere System.Drawing.Common supportato solo in Windows.

Costruttori

PrinterSettings()

Inizializza una nuova istanza della classe PrinterSettings.

Proprietà

CanDuplex	Ottiene un valore che indica se la stampante supporta la stampa fronte retro.
Collate	Ottiene o imposta un valore che indica se il documento stampato è fascicolato.
Copies	Ottiene o imposta il numero di copie del documento da stampare.
DefaultPageSettings	Ottiene le impostazioni di pagina predefinite per questa stampante.
Duplex	Ottiene o imposta le impostazioni della stampante per la stampa fronte retro.
FromPage	Ottiene o imposta il numero di pagina della prima pagina da stampare.
InstalledPrinters	Ottiene i nomi di tutte le stampanti installate nel computer.
IsDefaultPrinter	Ottiene un valore che indica se la proprietà PrinterName definisce la stampante predefinita, tranne quando l'utente imposta esplicitamente la proprietà PrinterName.
IsPlotter	Ottiene un valore che indica se la stampante è un plotter.
IsValid	Ottiene un valore che indica se la proprietà PrinterName definisce una stampante valida.
LandscapeAngle	Ottiene l'angolo di rotazione, espresso in gradi, dell'orientamento verticale per generare l'orientamento orizzontale.
MaximumCopies	Ottiene il numero massimo di copie alla volta di cui la stampante supporta la stampa.
MaximumPage	Ottiene o imposta il valore massimo di FromPage o ToPage che può essere selezionato in un oggetto PrintDialog.
MinimumPage	Ottiene o imposta il valore minimo di FromPage o ToPage che può essere selezionato in un oggetto PrintDialog.
PaperSizes	Ottiene i formati della carta supportati da questa stampante.
PaperSources	Ottiene i cassetti di alimentazione disponibili nella stampante.
PrinterName	Ottiene o imposta il nome della stampante da utilizzare.
PrinterResolutions	Ottiene tutte le risoluzioni supportate da questa stampante.
PrintFileName	Ottiene o imposta il nome file, durante la stampa su un file.
PrintRange	Ottiene o imposta i numeri di pagina specificati dall'utente per la stampa.
PrintToFile	Ottiene o imposta un valore che indica se l'output di stampa viene inviato in un file piuttosto che a una porta.
SupportsColor	Ottiene un valore che indica se questa stampante supporta la stampa a colori.
ToPage	Ottiene o imposta il numero dell'ultima pagina da stampare.

Metodi

Clone()	Crea una copia dell'oggetto PrinterSettings.
CreateMeasurementGraphics()	Restituisce un oggetto Graphics che contiene le informazioni della stampante utili per la creazione di una classe PrintDocument.
CreateMeasurementGraphics(Boolean)	Restituisce un oggetto Graphics che contiene le informazioni della stampante, in cui viene eventualmente specificata l'origine in corrispondenza dei margini.
CreateMeasurementGraphics(PageSettings)	Restituisce un oggetto Graphics contenente le informazioni della stampante associate alla classe PageSettings specificata.
CreateMeasurementGraphics(PageSettings, Boolean)	Crea un oggetto Graphics associato alle impostazioni della pagina specificate, in cui viene eventualmente specificata l'origine in corrispondenza dei margini.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetHdevmode()	Crea un handle per una struttura DEVMODE che corrisponde alle impostazioni della stampante.
GetHdevmode(PageSettings)	Crea un handle per una struttura DEVMODE che corrisponde alle impostazioni della stampante e della pagina specificate tramite il parametro pageSettings.
GetHdevnames()	Crea un handle per una struttura DEVNAMES che corrisponde alle impostazioni della stampante.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDirectPrintingSupported(Image)	Ottiene un valore che indica se la stampante supporta la stampa del file di immagine specificato.
IsDirectPrintingSupported(ImageFormat)	Restituisce un valore che indica se la stampante supporta la stampa del formato immagine specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
SetHdevmode(IntPtr)	Copia le informazioni rilevanti dall'handle specificato all'interno di PrinterSettings.
SetHdevnames(IntPtr)	Copia le informazioni rilevanti dall'handle specificato all'interno di PrinterSettings.
ToString()	Fornisce informazioni sulla classe PrinterSettings, sotto forma di stringa.

Vedi anche

• PrinterName
• PrinterSettings
• PrinterSettings