PrinterSettings Classe

Définition

Espace de noms:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

PrinterSettings.cs

Spécifie les informations sur l'impression d'un document, notamment le nom de l'imprimante, lors de l'impression à partir d'une application Windows Forms.

public ref class PrinterSettings : ICloneable

public class PrinterSettings : ICloneable

type PrinterSettings = class
    interface ICloneable

Public Class PrinterSettings
Implements ICloneable

Héritage

Object

PrinterSettings

Implémente

ICloneable

Exemples

L’exemple de code suivant imprime un document sur l’imprimante spécifiée. L’exemple présente trois conditions préalables :

• Une variable nommée filePath a été définie sur le chemin du fichier à imprimer.

• Une méthode nommée pd_PrintPage, qui gère l’événement PrintPage , a été définie.

• Une variable nommée printer a été définie sur le nom de l’imprimante.

Utilisez les System.Drawingespaces de noms , System.Drawing.Printinget System.IO pour cet exemple.

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

Remarques

En règle générale, vous accédez à des PrinterSettings propriétés via PrintDocument.PrinterSettings ou PageSettings.PrinterSettings pour modifier les paramètres de l’imprimante. Le paramètre d’imprimante le plus courant est PrinterName, qui spécifie l’imprimante sur laquelle imprimer.

Pour plus d’informations sur l’impression avec Windows Forms, consultez vue d’ensemble de l’espace System.Drawing.Printing de noms. Si vous souhaitez imprimer à partir d’une application Windows Presentation Foundation, consultez l’espace de System.Printing noms.

Notes

Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, est uniquement pris en charge sur les systèmes d’exploitation Windows. L’utilisation de ce type dans les applications multiplateformes entraîne des avertissements au moment de la compilation et des exceptions au moment de l’exécution. Pour plus d’informations, consultez System.Drawing.Common uniquement pris en charge sur Windows.

Constructeurs

PrinterSettings()

Initialise une nouvelle instance de la classe PrinterSettings.

Propriétés

CanDuplex	Obtient une valeur indiquant si l'imprimante prend en charge l'impression recto verso.
Collate	Obtient ou définit une valeur indiquant si les copies du document imprimé sont assemblées.
Copies	Obtient ou définit le nombre de copies du document à imprimer.
DefaultPageSettings	Obtient les paramètres par défaut de la page pour cette imprimante.
Duplex	Obtient ou définit le paramètre d'impression relatif à l'impression recto verso.
FromPage	Obtient ou définit le numéro de la première page à imprimer.
InstalledPrinters	Obtient les noms de toutes les imprimantes installées sur l'ordinateur.
IsDefaultPrinter	Obtient une valeur indiquant si la propriété PrinterName désigne l'imprimante par défaut, sauf si l'utilisateur définit explicitement PrinterName.
IsPlotter	Obtient une valeur indiquant si l'imprimante est un traceur.
IsValid	Obtient une valeur indiquant si la propriété PrinterName désigne une imprimante valide.
LandscapeAngle	Obtient l'angle, en degrés, de rotation qui permet de passer d'une orientation portrait à une orientation paysage.
MaximumCopies	Obtient le nombre maximal de copies pouvant être imprimées par l'imprimante à la fois.
MaximumPage	Obtient ou définit le FromPage ou ToPage maximal pouvant être sélectionné dans un objet PrintDialog.
MinimumPage	Obtient ou définit le FromPage ou ToPage minimal pouvant être sélectionné dans un objet PrintDialog.
PaperSizes	Obtient les tailles du papier prises en charge par cette imprimante.
PaperSources	Obtient les bacs d'alimentation papier disponibles sur cette imprimante.
PrinterName	Obtient ou définit le nom de l'imprimante à utiliser.
PrinterResolutions	Obtient toutes les résolutions prises en charge par cette imprimante.
PrintFileName	Obtient ou définit le nom de fichier, lors de l'impression dans un fichier.
PrintRange	Obtient ou définit les numéros de page à imprimer spécifiées par l'utilisateur.
PrintToFile	Obtient ou définit une valeur indiquant si la sortie d'impression est envoyée à un fichier plutôt qu'à un port.
SupportsColor	Obtient une valeur indiquant si l'imprimante prend en charge l'impression en couleur.
ToPage	Obtient ou définit le numéro de la dernière page à imprimer.

Méthodes

Clone()	Crée une copie de ce PrinterSettings.
CreateMeasurementGraphics()	Retourne un Graphics qui contient des informations sur l'imprimante qui sont utiles lors de la création d'un PrintDocument.
CreateMeasurementGraphics(Boolean)	Retourne un Graphics qui contient des informations sur l'imprimante, spécifiant éventuellement l'origine aux marges.
CreateMeasurementGraphics(PageSettings)	Retourne un Graphics qui contient des informations sur l'imprimante associée au PageSettings spécifié.
CreateMeasurementGraphics(PageSettings, Boolean)	Crée un Graphics associé aux paramètres de mise en page spécifiés et spécifiant éventuellement l'origine aux marges.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetHdevmode()	Crée un handle de structure DEVMODE qui correspond aux paramètres d'impression.
GetHdevmode(PageSettings)	Crée un handle de structure DEVMODE qui correspond aux paramètres d'imprimante et de page spécifiés par le paramètre pageSettings.
GetHdevnames()	Crée un handle de structure DEVNAMES qui correspond aux paramètres d'impression.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDirectPrintingSupported(Image)	Obtient une valeur indiquant si l'imprimante prend en charge l'impression du fichier image spécifié.
IsDirectPrintingSupported(ImageFormat)	Retourne une valeur indiquant si l'imprimante prend en charge l'impression du format d'image spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
SetHdevmode(IntPtr)	Copie les informations appropriées du handle spécifié dans la classe PrinterSettings.
SetHdevnames(IntPtr)	Copie les informations appropriées du handle spécifié dans la classe PrinterSettings.
ToString()	Fournit des informations à propos du PrinterSettings sous forme de chaîne.

Voir aussi

• PrinterName
• PrinterSettings
• PrinterSettings