Comment définir la taille de papier pour imprimer un document en C

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

Nous définissons la taille de 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;

// Send the document 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

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

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

Si aucun PaperSize n'est spécifié, IronPrint utilise PaperSize.PrinterDefault, qui se réfère à la taille de papier par défaut de l'imprimante configurée par le 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 inclut douze valeurs couvrant les normes internationales ISO, les tailles courantes aux États-Unis et le paramètre 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 que l'imprimante est actuellement configurée pour utiliser — utile lorsque vous souhaitez respecter les préférences 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;

// Build a fully configured print job
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

// Print a multi-page report with these settings
Printer.Print("quarterly-report.pdf", settings);

Imports IronPrint

' Build a fully configured print job
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 a multi-page report with these settings
Printer.Print("quarterly-report.pdf", settings)

Nous utilisons la syntaxe de l'initialiseur d'objet ici pour plus de clarté. PaperOrientation.Landscape fait pivoter la feuille A4 sur son axe le plus large. Dpi à 300 assure une sortie nette pour les graphiques et le texte fin. PaperMargins accepte quatre valeurs en millimètres — haut, droite, bas, gauche — via le constructeur Margins. La propriété Grayscale est par défaut à false, mais nous la définissons 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ù bloquer le thread principal n'est pas une option — telles que les apps WPF ou WinForms — nous utilisons Printer.PrintAsync. La méthode accepte le même objet PrintSettings et retourne 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 for contracts and legal documents
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

        // Print without blocking the UI thread
        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 for contracts and legal documents
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

        ' Print without blocking the UI thread
        Await Printer.PrintAsync(filePath, settings)
    End Function
End Class

Cet exemple basé sur une classe démontre un modèle réaliste où un service DocumentPrinter enveloppe la logique d'impression. 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 le travail d'impression.

Nous pouvons appeler cette méthode depuis un gestionnaire de clics de bouton, un service en arrière-plan ou n'importe où où await est pris en charge. Les méthodes asynchrones d'IronPrint — y compris PrintAsync et ShowPrintDialogAsync — acceptent la même configuration PrintSettings, donc le comportement de la taille de papier est identique entre les chemins synchrones et asynchrones.

Quelles Sont Mes Prochaines Étapes ?

Nous avons couvert comment définir la taille de papier en C# en utilisant l'énumération PaperSize d'IronPrint, de la configuration de base d'une seule propriété aux paramètres combinés et à l'impression asynchrone. La classe PrintSettings fournit une API propre et fortement typée qui élimine les incertitudes sur 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
• Parcourez la référence complète de l'API pour des classes comme Printer, PrintSettings et 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.