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.Specifies information about how a document is printed, including the printer that prints it, when printing from a Windows Forms application.

public ref class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
type PrinterSettings = class
    interface ICloneable
Public Class PrinterSettings
Implements ICloneable
Ereditarietà
PrinterSettings
Attributi
Implementazioni

Esempi

Nell'esempio di codice riportato di seguito viene stampato un documento sulla stampante specificata.The following code example prints a document on the specified printer. Nell'esempio sono presenti tre prerequisiti:The example has three prerequisites:

  • Una variabile denominata filePath è stata impostata sul percorso del file da stampare.A variable named filePath has been set to the path of the file to print.

  • È stato definito pd_PrintPageun metodo denominato, PrintPage che gestisce l'evento.A method named pd_PrintPage, which handles the PrintPage event, has been defined.

  • Una variabile denominata printer è stata impostata sul nome della stampante.A variable named printer has been set to the printer's name.

Usare gli System.Drawingspazi System.Drawing.Printingdei nomi System.IO , e per questo esempio.Use the System.Drawing, System.Drawing.Printing, and System.IO namespaces for this example.

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, è possibile PrinterSettings accedere PrintDocument.PrinterSettings a PageSettings.PrinterSettings tramite le proprietà o per modificare le impostazioni della stampante.Typically, you access a PrinterSettings through PrintDocument.PrinterSettings or PageSettings.PrinterSettings properties to modify printer settings. L'impostazione della stampante più comune PrinterNameè, che specifica la stampante in cui stampare.The most common printer setting is PrinterName, which specifies the printer to print to.

Per ulteriori informazioni sulla stampa con Windows Forms, vedere System.Drawing.Printing Cenni preliminari sullo spazio dei nomi.For more information about printing with Windows Forms, see the System.Drawing.Printing namespace overview. Se si desidera stampare da un'applicazione Windows Presentation Foundation, vedere lo System.Printing spazio dei nomi.If you wish to print from a Windows Presentation Foundation application, see the System.Printing namespace.

Costruttori

PrinterSettings()

Inizializza una nuova istanza della classe PrinterSettings.Initializes a new instance of the PrinterSettings class.

Proprietà

CanDuplex

Ottiene un valore che indica se la stampante supporta la stampa fronte retro.Gets a value indicating whether the printer supports double-sided printing.

Collate

Ottiene o imposta un valore che indica se il documento stampato è fascicolato.Gets or sets a value indicating whether the printed document is collated.

Copies

Ottiene o imposta il numero di copie del documento da stampare.Gets or sets the number of copies of the document to print.

DefaultPageSettings

Ottiene le impostazioni di pagina predefinite per questa stampante.Gets the default page settings for this printer.

Duplex

Ottiene o imposta le impostazioni della stampante per la stampa fronte retro.Gets or sets the printer setting for double-sided printing.

FromPage

Ottiene o imposta il numero di pagina della prima pagina da stampare.Gets or sets the page number of the first page to print.

InstalledPrinters

Ottiene i nomi di tutte le stampanti installate nel computer.Gets the names of all printers installed on the computer.

IsDefaultPrinter

Ottiene un valore che indica se la proprietà PrinterName definisce la stampante predefinita, tranne quando l'utente imposta esplicitamente la proprietà PrinterName.Gets a value indicating whether the PrinterName property designates the default printer, except when the user explicitly sets PrinterName.

IsPlotter

Ottiene un valore che indica se la stampante è un plotter.Gets a value indicating whether the printer is a plotter.

IsValid

Ottiene un valore che indica se la proprietà PrinterName definisce una stampante valida.Gets a value indicating whether the PrinterName property designates a valid printer.

LandscapeAngle

Ottiene l'angolo di rotazione, espresso in gradi, dell'orientamento verticale per generare l'orientamento orizzontale.Gets the angle, in degrees, that the portrait orientation is rotated to produce the landscape orientation.

MaximumCopies

Ottiene il numero massimo di copie alla volta di cui la stampante supporta la stampa.Gets the maximum number of copies that the printer enables the user to print at a time.

MaximumPage

Ottiene o imposta il valore massimo di FromPage o ToPage che può essere selezionato in un oggetto PrintDialog.Gets or sets the maximum FromPage or ToPage that can be selected in a PrintDialog.

MinimumPage

Ottiene o imposta il valore minimo di FromPage o ToPage che può essere selezionato in un oggetto PrintDialog.Gets or sets the minimum FromPage or ToPage that can be selected in a PrintDialog.

PaperSizes

Ottiene i formati della carta supportati da questa stampante.Gets the paper sizes that are supported by this printer.

PaperSources

Ottiene i cassetti di alimentazione disponibili nella stampante.Gets the paper source trays that are available on the printer.

PrinterName

Ottiene o imposta il nome della stampante da utilizzare.Gets or sets the name of the printer to use.

PrinterResolutions

Ottiene tutte le risoluzioni supportate da questa stampante.Gets all the resolutions that are supported by this printer.

PrintFileName

Ottiene o imposta il nome file, durante la stampa su un file.Gets or sets the file name, when printing to a file.

PrintRange

Ottiene o imposta i numeri di pagina specificati dall'utente per la stampa.Gets or sets the page numbers that the user has specified to be printed.

PrintToFile

Ottiene o imposta un valore che indica se l'output di stampa viene inviato in un file piuttosto che a una porta.Gets or sets a value indicating whether the printing output is sent to a file instead of a port.

SupportsColor

Ottiene un valore che indica se questa stampante supporta la stampa a colori.Gets a value indicating whether this printer supports color printing.

ToPage

Ottiene o imposta il numero dell'ultima pagina da stampare.Gets or sets the number of the last page to print.

Metodi

Clone()

Crea una copia dell'oggetto PrinterSettings.Creates a copy of this PrinterSettings.

CreateMeasurementGraphics()

Restituisce un oggetto Graphics che contiene le informazioni della stampante utili per la creazione di una classe PrintDocument.Returns a Graphics that contains printer information that is useful when creating a PrintDocument.

CreateMeasurementGraphics(Boolean)

Restituisce un oggetto Graphics che contiene le informazioni della stampante, in cui viene eventualmente specificata l'origine in corrispondenza dei margini.Returns a Graphics that contains printer information, optionally specifying the origin at the margins.

CreateMeasurementGraphics(PageSettings)

Restituisce un oggetto Graphics contenente le informazioni della stampante associate alla classe PageSettings specificata.Returns a Graphics that contains printer information associated with the specified PageSettings.

CreateMeasurementGraphics(PageSettings, Boolean)

Crea un oggetto Graphics associato alle impostazioni della pagina specificate, in cui viene eventualmente specificata l'origine in corrispondenza dei margini.Creates a Graphics associated with the specified page settings and optionally specifying the origin at the margins.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetHdevmode()

Crea un handle per una struttura DEVMODE che corrisponde alle impostazioni della stampante.Creates a handle to a DEVMODE structure that corresponds to the printer settings.

GetHdevmode(PageSettings)

Crea un handle per una struttura DEVMODE che corrisponde alle impostazioni della stampante e della pagina specificate tramite il parametro pageSettings.Creates a handle to a DEVMODE structure that corresponds to the printer and the page settings specified through the pageSettings parameter.

GetHdevnames()

Crea un handle per una struttura DEVNAMES che corrisponde alle impostazioni della stampante.Creates a handle to a DEVNAMES structure that corresponds to the printer settings.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
IsDirectPrintingSupported(Image)

Ottiene un valore che indica se la stampante supporta la stampa del file di immagine specificato.Gets a value indicating whether the printer supports printing the specified image file.

IsDirectPrintingSupported(ImageFormat)

Restituisce un valore che indica se la stampante supporta la stampa del formato immagine specificato.Returns a value indicating whether the printer supports printing the specified image format.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
SetHdevmode(IntPtr)

Copia le informazioni rilevanti dall'handle specificato all'interno di PrinterSettings.Copies the relevant information out of the given handle and into the PrinterSettings.

SetHdevnames(IntPtr)

Copia le informazioni rilevanti dall'handle specificato all'interno di PrinterSettings.Copies the relevant information out of the given handle and into the PrinterSettings.

ToString()

Fornisce informazioni sulla classe PrinterSettings, sotto forma di stringa.Provides information about the PrinterSettings in string form.

Si applica a

Vedi anche