PrinterSettings Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 |
| GetHdevmode(PageSettings) |
Crea un handle per una |
| GetHdevnames() |
Crea un handle per una |
| 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. |