Comment Définir l'Orientation du Papier pour Imprimer un Document en C

Comment définir l'orientation du papier pour l'impression ?

La propriété PaperOrientation sur PrintSettings accepte trois valeurs :

• PaperOrientation.Portrait — mise en page verticale (valeur par défaut sur la plupart des imprimantes). Idéal pour les documents à colonne unique comme les lettres, contrats et factures.
• PaperOrientation.Landscape — mise en page horizontale. Idéal pour le contenu large tel que les tableaux de données, diagrammes de Gantt, feuilles de calcul et supports de présentation.
• PaperOrientation.Automatic — se réfère au paramètre par défaut de l'imprimante.

Nous créons un objet PrintSettings, attribuons l'orientation souhaitée, et le transmettons à Printer.Print() pour une impression silencieuse ou à Printer.ShowPrintDialog() pour une impression avec boîte de dialogue.

:path=/static-assets/print/content-code-examples/how-to/set-paper-orientation/set-paper-orientation-portrait-and-landscape-orientation.cs

using IronPrint;

// Portrait orientation — standard for letters and invoices
var portraitSettings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Portrait
};
Printer.Print("invoice.pdf", portraitSettings);

// Landscape orientation — ideal for wide tables and dashboards
var landscapeSettings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape
};
Printer.Print("quarterly-dashboard.pdf", landscapeSettings);

Imports IronPrint

' Portrait orientation — standard for letters and invoices
Dim portraitSettings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Portrait
}
Printer.Print("invoice.pdf", portraitSettings)

' Landscape orientation — ideal for wide tables and dashboards
Dim landscapeSettings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Landscape
}
Printer.Print("quarterly-dashboard.pdf", landscapeSettings)

Avec l'approche native .NET System.Drawing.Printing, l'orientation est un booléen (DefaultPageSettings.Landscape = true) enfoui dans un PrintDocument qui nécessite également une gestion des événements PrintPage, un rendu graphique, et une gestion manuelle des pages. IronPrint remplace tout ce pipeline par une seule propriété sur un objet de paramètres.

Comment combiner l'orientation avec d'autres paramètres d'impression ?

L'orientation est le plus utile quand elle est combinée avec la taille du papier, le DPI, et les marges pour définir une mise en page complète. La classe PrintSettings nous permet de configurer tous ces éléments dans un seul objet.

:path=/static-assets/print/content-code-examples/how-to/set-paper-orientation/set-paper-orientation-combine-orientation-with-settings.cs

using IronPrint;

var settings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape,
    PaperSize = PaperSize.A4,
    Dpi = 300,
    NumberOfCopies = 1,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

Printer.Print("financial-report.pdf", settings);

Imports IronPrint

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

Printer.Print("financial-report.pdf", settings)

PaperSize et PaperOrientation fonctionnent ensemble — définir le paysage A4 donne une surface d'impression de 297 × 210 mm, tandis que le portrait A4 donne 210 × 297 mm. La propriété Dpi contrôle la résolution de sortie (300 est standard pour les documents d'entreprise), et les valeurs PaperMargins sont en millimètres.

Comment permettre aux utilisateurs de choisir l'orientation dans la boîte de dialogue d'impression ?

Lorsque nous passons PrintSettings à Printer.ShowPrintDialog(), le dialogue s'ouvre avec notre orientation présélectionnée. L'utilisateur peut l'accepter ou passer entre portrait et paysage avant d'imprimer.

:path=/static-assets/print/content-code-examples/how-to/set-paper-orientation/set-paper-orientation-dialog-with-orientation-preset.cs

using IronPrint;

// Pre-select landscape, but let the user override in the dialog
var settings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape,
    PaperSize = PaperSize.Letter
};

Printer.ShowPrintDialog("wide-report.pdf", settings);

Imports IronPrint

' Pre-select landscape, but let the user override in the dialog
Dim settings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Landscape,
    .PaperSize = PaperSize.Letter
}

Printer.ShowPrintDialog("wide-report.pdf", settings)

Pour les scénarios UI non bloquants, la variante asynchrone Printer.ShowPrintDialogAsync() accepte les mêmes paramètres et maintient l'application réactive pendant que le dialogue est ouvert. C'est particulièrement utile pour l'orientation, car les utilisateurs souhaitent souvent prévisualiser l'aspect d'un document en portrait par rapport au paysage avant de s'engager dans un tirage. Le tutoriel d'impression de documents couvre les flux de travail silencieux et avec dialogue de bout en bout.

Prochaines étapes

L'orientation du papier est une propriété de l'objet PrintSettings — définissez PaperOrientation sur Portrait, Landscape, ou Automatic et transmettez-le à n'importe quelle méthode d'impression IronPrint. Combinez-le avec PaperSize, Dpi, et PaperMargins pour un contrôle de mise en page complet.

Explorez le guide des paramètres d'impression pour chaque propriété disponible, la référence API de la classe Printer pour l'ensemble des méthodes, ou la page d'exemples de code pour des extraits prêts à l'emploi. Les tutoriels IronPrint couvrent le cycle de vie complet de l'impression, et le journal des modifications suit les mises à jour récentes, y compris les améliorations de performance.

Commencez un essai gratuit de 30 jours pour tester les paramètres d'orientation dans un projet en direct. Lorsque vous êtes prêt, consultez les options de licence à partir de 749 $.