PrinterSettings Classe

Définition

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
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
[System.Serializable]
public class PrinterSettings : ICloneable
type PrinterSettings = class
    interface 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
Héritage
PrinterSettings
Attributs
Implémente

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.

S’applique à

Voir aussi