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 la taille du papier en attribuant une valeur de l'énum PaperSize à la propriété PaperSize sur 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 commençons par initier 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. Quand 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 que l'imprimante par défaut du système d'exploitation est configurée pour utiliser. 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 PaperSize comprend douze valeurs couvrant les normes internationales ISO, les formats américains courants, et le 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 actuelle pour laquelle l'imprimante est configurée - utile lorsque vous souhaitez respecter les préférences d'imprimante 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 assure une sortie nette pour les graphiques et le texte fin. Margins accepte quatre valeurs en millimètres - haut, droite, bas, gauche - par le constructeur Margins. La propriété CopyCount utilise par défaut 1, mais nous le définissons explicitement pour une meilleure 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 fil principal n'est pas une option - comme 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 une classe démontre un modèle réaliste où un service DocumentPrinter encapsule la logique d'impression. Nous configurons PaperSize.Legal (8,5 × 14 pouces), qui est le format standard pour les contrats et les documents légaux. Le mot-clé await garantit que le fil d'appel reste réactif pendant qu'IronPrint traite la tâche d'impression.

Nous pouvons appeler cette méthode à partir d'un gestionnaire de clic de bouton, d'un service en arrière-plan, ou de 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 du papier est identique entre les chemins synchrone et asynchrone.

Quelles Sont Mes Prochaines Étapes ?

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