PrinterSettings Classe

Définition

Spécifie des informations sur l’impression d’un document, y compris l’imprimante qui l’imprime, 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 prérequis :

  • Une variable nommée filePath a été définie sur le chemin d’accès 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 espaces de noms et System.Drawing les System.Drawing.Printingespaces System.IOde noms 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 à un accès via PrinterSettings ou PrintDocument.PrinterSettings à des PageSettings.PrinterSettings propriétés pour modifier les paramètres de l’imprimante. Le paramètre d’imprimante le plus courant est PrinterName, qui spécifie l’imprimante à imprimer.

Pour plus d’informations sur l’impression avec Windows Forms, consultez la 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 System.Printing de noms.

Note

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

Constructeurs

Nom Description
PrinterSettings()

Initialise une nouvelle instance de la classe PrinterSettings.

Propriétés

Nom Description
CanDuplex

Obtient une valeur indiquant si l’imprimante prend en charge l’impression double face.

Collate

Obtient ou définit une valeur indiquant si le document imprimé est compilé.

Copies

Obtient ou définit le nombre de copies du document à imprimer.

DefaultPageSettings

Obtient les paramètres de page par défaut pour cette imprimante.

Duplex

Obtient ou définit le paramètre d’imprimante pour l’impression double face.

FromPage

Obtient ou définit le numéro de page 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 PrinterName propriété désigne l’imprimante par défaut, sauf lorsque l’utilisateur définit PrinterNameexplicitement .

IsPlotter

Obtient une valeur indiquant si l’imprimante est un plotter.

IsValid

Obtient une valeur indiquant si la PrinterName propriété désigne une imprimante valide.

LandscapeAngle

Obtient l’angle, en degrés, que l’orientation portrait est pivotée pour produire l’orientation paysage.

MaximumCopies

Obtient le nombre maximal de copies que l’imprimante permet à l’utilisateur d’imprimer à la fois.

MaximumPage

Obtient ou définit la valeur maximale FromPage ou ToPage qui peut être sélectionnée dans un PrintDialog.

MinimumPage

Obtient ou définit le minimum FromPage ou ToPage qui peut être sélectionné dans un PrintDialog.

PaperSizes

Obtient les tailles de papier prises en charge par cette imprimante.

PaperSources

Obtient les bacs sources de papier disponibles sur l’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 du fichier lors de l’impression dans un fichier.

PrintRange

Obtient ou définit les numéros de page que l’utilisateur a spécifiés pour être imprimés.

PrintToFile

Obtient ou définit une valeur indiquant si la sortie d’impression est envoyée à un fichier au lieu d’un port.

SupportsColor

Obtient une valeur indiquant si cette imprimante prend en charge l’impression de couleurs.

ToPage

Obtient ou définit le nombre de la dernière page à imprimer.

Méthodes

Nom Description
Clone()

Crée une copie de ce PrinterSettingsfichier .

CreateMeasurementGraphics()

Retourne une Graphics valeur qui contient des informations sur l’imprimante utiles lors de la création d’un PrintDocumentfichier .

CreateMeasurementGraphics(Boolean)

Retourne une Graphics valeur qui contient des informations sur l’imprimante, en spécifiant éventuellement l’origine aux marges.

CreateMeasurementGraphics(PageSettings, Boolean)

Crée un Graphics associé aux paramètres de page spécifiés et spécifie éventuellement l’origine aux marges.

CreateMeasurementGraphics(PageSettings)

Retourne une Graphics valeur qui contient des informations d’imprimante associées à l’objet spécifié PageSettings.

Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetHdevmode()

Crée un handle dans une DEVMODE structure qui correspond aux paramètres de l’imprimante.

GetHdevmode(PageSettings)

Crée un handle dans une DEVMODE structure qui correspond à l’imprimante et aux paramètres de page spécifiés via le pageSettings paramètre.

GetHdevnames()

Crée un handle dans une DEVNAMES structure qui correspond aux paramètres de l’imprimante.

GetType()

Obtient la 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 Objectactuel.

(Hérité de Object)
SetHdevmode(IntPtr)

Copie les informations pertinentes à partir du handle donné et dans le PrinterSettings.

SetHdevnames(IntPtr)

Copie les informations pertinentes à partir du handle donné et dans le PrinterSettings.

ToString()

Fournit des informations sur le PrinterSettings formulaire de chaîne.

S’applique à

Voir aussi