PrinterSettings Classe

Definizione

Specifica le informazioni sulla stampa di un documento, inclusa la stampante che la stampa, durante la stampa da un'applicazione Windows Form.

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

Esempio

Nell'esempio di codice seguente viene stampato un documento sulla stampante specificata. L'esempio presenta 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 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 su cui stampare.

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

Note

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 in fase di esecuzione. Per altre informazioni, vedere System.Drawing.Common supportato solo in Windows.

Costruttori

Nome Descrizione
PrinterSettings()

Inizializza una nuova istanza della classe PrinterSettings.

Proprietà

Nome Descrizione
CanDuplex

Ottiene un valore che indica se la stampante supporta la stampa a doppio lato.

Collate

Ottiene o imposta un valore che indica se il documento stampato è compresso.

Copies

Ottiene o imposta il numero di copie del documento da stampare.

DefaultPageSettings

Ottiene le impostazioni di pagina predefinite per la stampante.

Duplex

Ottiene o imposta l'impostazione della stampante per la stampa a doppio lato.

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à designa la PrinterName stampante predefinita, tranne quando l'utente imposta PrinterNamein modo esplicito .

IsPlotter

Ottiene un valore che indica se la stampante è un plotter.

IsValid

Ottiene un valore che indica se la PrinterName proprietà designa una stampante valida.

LandscapeAngle

Ottiene l'angolo, espresso in gradi, che l'orientamento verticale viene ruotato per produrre l'orientamento orizzontale.

MaximumCopies

Ottiene il numero massimo di copie che la stampante consente all'utente di stampare alla volta.

MaximumPage

Ottiene o imposta il valore massimo FromPage o ToPage che può essere selezionato in un oggetto PrintDialog.

MinimumPage

Ottiene o imposta il valore minimo FromPage o ToPage che può essere selezionato in un oggetto PrintDialog.

PaperSizes

Ottiene le dimensioni della carta supportate dalla stampante.

PaperSources

Ottiene il vassoio di origine della carta disponibile sulla stampante.

PrinterName

Ottiene o imposta il nome della stampante da utilizzare.

PrinterResolutions

Ottiene tutte le risoluzioni supportate dalla stampante.

PrintFileName

Ottiene o imposta il nome del file durante la stampa in 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 a un file anziché a una porta.

SupportsColor

Ottiene un valore che indica se la stampante supporta la stampa a colori.

ToPage

Ottiene o imposta il numero dell'ultima pagina da stampare.

Metodi

Nome Descrizione
Clone()

Crea una copia dell'oggetto PrinterSettings.

CreateMeasurementGraphics()

Restituisce un oggetto Graphics contenente informazioni sulla stampante utili durante la creazione di un oggetto PrintDocument.

CreateMeasurementGraphics(Boolean)

Restituisce un oggetto Graphics contenente informazioni sulla stampante, specificando facoltativamente l'origine ai margini.

CreateMeasurementGraphics(PageSettings, Boolean)

Crea un Graphics oggetto associato alle impostazioni di pagina specificate e, facoltativamente, specificando l'origine ai margini.

CreateMeasurementGraphics(PageSettings)

Restituisce un oggetto Graphics contenente le informazioni sulla stampante associate all'oggetto specificato PageSettings.

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 DEVMODE struttura che corrisponde alle impostazioni della stampante.

GetHdevmode(PageSettings)

Crea un handle per una DEVMODE struttura che corrisponde alla stampante e alle impostazioni della pagina specificate tramite il pageSettings parametro .

GetHdevnames()

Crea un handle per una DEVNAMES struttura che corrisponde alle impostazioni della stampante.

GetType()

Ottiene il 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 di immagine specificato.

MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
SetHdevmode(IntPtr)

Copia le informazioni pertinenti dall'handle specificato e in PrinterSettings.

SetHdevnames(IntPtr)

Copia le informazioni pertinenti dall'handle specificato e in PrinterSettings.

ToString()

Fornisce informazioni sull'oggetto PrinterSettings in formato stringa.

Si applica a

Vedi anche