PageSettings Classe

Definizione

Spazio dei nomi:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

PageSettings.cs

Specifica impostazioni che si applicano a una singola pagina stampata.

public ref class PageSettings : ICloneable

public class PageSettings : ICloneable

type PageSettings = class
    interface ICloneable

Public Class PageSettings
Implements ICloneable

Ereditarietà

Object

PageSettings

Implementazioni

ICloneable

Esempio

Nell'esempio seguente viene illustrata la gestione dell'evento e il controllo dell'argomento PrintPagePageSettings di PrintPageEventArgs. Per usare questo codice, aggiungere un PrintDocument componente denominato PrintDocument1 a un Windows Form e associarne PrintPage l'evento al metodo nell'esempio printDocument1_PrintPage .

private void printDocument1_PrintPage(object sender, System.Drawing.Printing.PrintPageEventArgs e)
{
    if (e.PageSettings.Color && !printDocument1.PrinterSettings.SupportsColor)
        MessageBox.Show("Color printing not supported on selected printer.", "Printer Warning", MessageBoxButtons.OKCancel);
}

Private Sub printDocument1_PrintPage(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintPageEventArgs)  Handles printDocument1.PrintPage
    If e.PageSettings.Color AndAlso Not printDocument1.PrinterSettings.SupportsColor Then
        MessageBox.Show("Color printing not supported on selected printer.", "Printer Warning", MessageBoxButtons.OKCancel)
    End If

End Sub

Commenti

La PageSettings classe viene usata per specificare le impostazioni che modificano la modalità di stampa di una pagina. In genere, si impostano le impostazioni predefinite per tutte le pagine da stampare tramite la PrintDocument.DefaultPageSettings proprietà . Per specificare le impostazioni in base a pagina, gestire rispettivamente l'evento PrintDocument.PrintPage o e modificare l'argomento PageSettings incluso in PrintPageEventArgs o QueryPageSettingsEventArgsPrintDocument.QueryPageSettings .

Per altre informazioni sulla gestione PrintDocument degli eventi, vedere panoramica della PrintDocument classe. Per altre informazioni sulla stampa, vedere panoramica dello System.Drawing.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

PageSettings()	Inizializza una nuova istanza della classe PageSettings utilizzando la stampante predefinita.
PageSettings(PrinterSettings)	Inizializza una nuova istanza della classe PageSettings utilizzando una stampante specificata.

Proprietà

Bounds	Ottiene le dimensioni della pagina, considerando l'orientamento della pagina specificato dalla proprietà Landscape.
Color	Ottiene o imposta un valore che indica se la pagina deve essere stampata a colori.
HardMarginX	Ottiene la coordinata x del margine fisso a sinistra della pagina, in centesimi di pollice.
HardMarginY	Ottiene la coordinata y del margine fisso nella parte superiore della pagina, in centesimi di pollice.
Landscape	Ottiene o imposta un valore che indica se la pagina deve essere stampata con orientamento orizzontale o verticale.
Margins	Ottiene o imposta i margini di questa pagina.
PaperSize	Ottiene o imposta il formato della carta per la pagina.
PaperSource	Ottiene o imposta il tipo di alimentazione della pagina, ad esempio il cassetto superiore della stampante.
PrintableArea	Ottiene i limiti dell'area stampabile della pagina per la stampante.
PrinterResolution	Ottiene o imposta la risoluzione di stampa per la pagina.
PrinterSettings	Ottiene o imposta le impostazioni della stampante associate alla pagina.

Metodi

Clone()	Crea una copia dell'oggetto PageSettings.
CopyToHdevmode(IntPtr)	Copia le informazioni rilevanti da PageSettings alla struttura DEVMODE specificata.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
SetHdevmode(IntPtr)	Copia le informazioni rilevanti in PageSettings dalla struttura DEVMODE specificata.
ToString()	Converte la classe PageSettings in formato stringa.

Vedi anche

• PrintDocument
• PrinterSettings