Cette documentation est archivée et n’est pas conservée.

PrinterSettings, classe

Mise à jour : novembre 2007

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.

Espace de noms :  System.Drawing.Printing
Assembly :  System.Drawing (dans System.Drawing.dll)

[SerializableAttribute]
public class PrinterSettings : ICloneable
/** @attribute SerializableAttribute */ 
public class PrinterSettings implements ICloneable
public class PrinterSettings implements ICloneable

En général, vous accédez à PrinterSettings via la propriété PrintDocument.PrinterSettings ou PageSettings.PrinterSettings pour modifier les paramètres d'impression. Le paramètre d'impression le plus courant est PrinterName, qui spécifie l'imprimante à utiliser.

Pour plus d'informations sur l'impression dans Windows Forms, consultez la vue d'ensemble de l'espace de noms System.Drawing.Printing. Pour imprimer à partir d'une application Windows Presentation Foundation, consultez l'espace de noms System.Printing.

Dans l'exemple de code suivant, un document est imprimé avec l'imprimante spécifiée. L'exemple se compose de trois composants requis :

  • Le chemin d'accès du fichier à imprimer a été affecté à une variable nommée filePath.

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

  • Le nom de l'imprimante a été affecté à une variable nommée printer.

Utilisez les espaces de noms System.Drawing, System.Drawing.Printing et System.IO pour cet exemple.

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 void Printing(String printer)
{
    try {
        streamToPrint = new StreamReader(filePath);
        try {
            printFont = new Font("Arial", 10);
            PrintDocument pd = new PrintDocument();
            pd.add_PrintPage(new PrintPageEventHandler(pd_PrintPage));

            // Specify the printer to use.
            pd.get_PrinterSettings().set_PrinterName(printer);
            if (pd.get_PrinterSettings().get_IsValid()) {
                pd.Print();
            }
            else {
                MessageBox.Show("Printer is invalid.");
            }
        }
        finally {
            streamToPrint.Close();
        }
    }
    catch (System.Exception ex) {
        MessageBox.Show(ex.get_Message());
    }
} //Printing


System.Object
  System.Drawing.Printing.PrinterSettings

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0
Afficher: