Comment définir la taille de papier pour l'impression en C

Comment définir la taille de papier lors de l'impression en C# ?

Nous définissons le format du papier en attribuant une valeur de l'énumération PaperSize à la propriété PaperSize d'un objet PrintSettings. Nous passons ensuite cet objet à l'une des méthodes d'impression d'IronPrint.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-set-paper-size.cs

using IronPrint;

// Configure print settings with US Letter paper
PrintSettings settings = new PrintSettings();
settings.PaperSize = PaperSize.Letter;

// Print to the default printer
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure print settings with US Letter paper
Dim settings As New PrintSettings()
settings.PaperSize = PaperSize.Letter

' Print to the default printer
Printer.Print("invoice.pdf", settings)

Nous instancions d'abord PrintSettings, qui s'initialise avec les paramètres par défaut de l'imprimante. Nous remplaçons ensuite PaperSize par PaperSize.Letter, qui correspond au format standard 8,5 × 11 pouces. Lorsque nous appelons Printer.Print, IronPrint envoie le document à l'imprimante par défaut du système en utilisant ce format de papier.

Si aucun PaperSize n'est spécifié, IronPrint utilise PaperSize.PrinterDefault, qui s'aligne sur le format de papier défini par défaut pour l'imprimante du système d'exploitation. C'est un détail essentiel pour les environnements de production où les configurations d'imprimante varient d'une machine à l'autre.

Quelles tailles de papier la bibliothèque prend-elle en charge ?

L'énumération PaperSize comprend douze valeurs couvrant les normes internationales ISO, les formats courants aux États-Unis et le réglage par défaut de l'imprimante. Le tableau ci-dessous liste chaque option disponible.

Chaque valeur correspond directement à une norme de papier bien connue. L'option PrinterDefault indique à IronPrint d'utiliser la taille pour laquelle l'imprimante est actuellement configurée — ce qui est utile lorsque vous souhaitez respecter les préférences d'impression de l'utilisateur final plutôt que d'imposer un format spécifique.

Pour une référence complète de l'API, consultez la documentation de la classe PaperSize.

Comment combiner la taille de papier avec d'autres paramètres d'impression ?

La classe PrintSettings expose plusieurs propriétés au-delà de PaperSize. Nous pouvons configurer l'orientation, les DPI, les marges, le nombre de copies et le mode niveaux de gris — le tout dans un seul objet.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-combined-settings.cs

using IronPrint;

// Configure full print settings
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

// Print the quarterly report
Printer.Print("quarterly-report.pdf", settings);

Imports IronPrint

' Configure full print settings
Dim settings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 300,
    .NumberOfCopies = 3,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

' Print the quarterly report
Printer.Print("quarterly-report.pdf", settings)

Nous utilisons la syntaxe de l'initialiseur d'objet ici pour plus de clarté. Orientation fait pivoter la feuille A4 sur son axe le plus large. DPI à 300 garantit un rendu net pour les graphiques et les textes fins. Margins accepte quatre valeurs en millimètres — haut, droite, bas, gauche — via le constructeur Margins. La propriété CopyCount est définie par défaut sur 1, mais nous l'avons définie explicitement pour plus de lisibilité.

Ces propriétés fonctionnent ensemble sans conflit. IronPrint valide la configuration et transmet les paramètres combinés au pilote d'imprimante sous forme d'un seul travail d'impression. Pour des paramètres plus avancés comme la sélection d'imprimante et la configuration du tiroir, référez-vous au guide complet des paramètres d'impression.

Comment imprimer de manière asynchrone avec une taille de papier personnalisée ?

Pour les applications où le blocage du thread principal n'est pas envisageable — telles que les applications WPF ou WinForms —, nous utilisons Printer.PrintAsync. La méthode accepte le même objet PrintSettings et renvoie un Task.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-async-print.cs

using IronPrint;
using System.Threading.Tasks;

public class DocumentPrinter
{
    public async Task PrintLegalDocumentAsync(string filePath)
    {
        // Configure Legal paper size
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

        // Print asynchronously
        await Printer.PrintAsync(filePath, settings);
    }
}

Imports IronPrint
Imports System.Threading.Tasks

Public Class DocumentPrinter
    Public Async Function PrintLegalDocumentAsync(filePath As String) As Task
        ' Configure Legal paper size
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

        ' Print asynchronously
        Await Printer.PrintAsync(filePath, settings)
    End Function
End Class

Cet exemple basé sur des classes illustre un schéma réaliste dans lequel un service DocumentPrinter encapsule la logique de PRINT. Nous configurons PaperSize.Legal (8,5 × 14 pouces), qui est le format standard pour les contrats et les documents juridiques. Le mot-clé await garantit que le thread appelant reste réactif pendant qu'IronPrint traite la tâche d'impression.

Nous pouvons appeler cette méthode à partir d'un gestionnaire de clic sur un bouton, d'un service d'arrière-plan ou de n'importe quel endroit où await est pris en charge. Les méthodes asynchrones d'IronPrint — notamment PrintAsync et ShowPrintDialogAsync — acceptent la même configuration PrintSettings, de sorte que le comportement relatif au format de papier est identique entre les chemins synchrones et asynchrones.

Quelles Sont Mes Prochaines Étapes ?

Nous avons abordé la manière de définir le format de papier en C# à l'aide de l'énumération PaperSize d'IronPrint, depuis la configuration de base à propriété unique jusqu'aux paramètres combinés et à l'impression asynchrone. La classe PrintSettings fournit une API épurée et fortement typée qui élimine toute incertitude concernant les dimensions du papier.

Pour continuer à explorer les capacités d'IronPrint :

• Apprenez comment configurer tous les paramètres d'impression y compris le nom de l'imprimante, le tiroir et le mode niveaux de gris
• Consultez des exemples de code de paramètres d'impression fonctionnels pour des scénarios courants
• Consultez la référence API complète pour des classes telles que Printer, PrintSettings, PaperSize

Commencez un essai gratuit de 30 jours pour tester la configuration de la taille de papier dans vos propres projets, ou consultez les options de licence pour le déploiement en production.

PaperOrientation.Landscape

Dpi

PaperMargins

Margins

Grayscale

false