PrinterSettings Classe

Definizione

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
[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
Ereditarietà
PrinterSettings
Attributi
Implementazioni

Esempio

Nell'esempio di codice seguente viene stampato un documento nella stampante specificata. Nell'esempio sono presenti tre prerequisiti:

  • Una variabile denominata filePath è stata impostata 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 System.Drawingspazi dei nomi , 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 alle proprietà per modificare le impostazioni della stampante. L'impostazione della stampante più comune è PrinterName, che specifica la stampante da stampare.

Per altre informazioni sulla stampa con Windows Forms, vedere panoramica dello System.Drawing.Printing spazio dei nomi. Se si desidera stampare da un'applicazione Windows Presentation Foundation, vedere lo System.Printing spazio dei 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 e eccezioni in fase di esecuzione. 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.

Si applica a

Vedi anche