Comment définir l'orientation du papier pour l'impression en C

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

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

• PaperOrientation.Portrait — mise en page verticale (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 — s'en remet au paramètre par défaut de l'imprimante.

Nous créons un objet PrintSettings, lui attribuons l'orientation souhaitée, puis 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;

// Configure portrait orientation
var portraitSettings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Portrait
};

// Print the invoice in portrait
Printer.Print("invoice.pdf", portraitSettings);

// Configure landscape orientation
var landscapeSettings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape
};

// Print the dashboard in landscape
Printer.Print("quarterly-dashboard.pdf", landscapeSettings);

Imports IronPrint

' Configure portrait orientation
Dim portraitSettings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Portrait
}

' Print the invoice in portrait
Printer.Print("invoice.pdf", portraitSettings)

' Configure landscape orientation
Dim landscapeSettings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Landscape
}

' Print the dashboard in landscape
Printer.Print("quarterly-dashboard.pdf", landscapeSettings)

Avec l'approche native .NET System.Drawing.Printing, l'orientation est une valeur booléenne (DefaultPageSettings.Landscape = true) intégrée dans un PrintDocument qui nécessite également la gestion d'événements PrintPage, le rendu graphique et la 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 tout cela 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;

// Combine orientation with paper size, DPI, and margins
var settings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape,
    PaperSize = PaperSize.A4,
    Dpi = 300,
    NumberOfCopies = 1,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

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

Imports IronPrint

' Combine orientation with paper size, DPI, and margins
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
}

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

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

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

Lorsque nous transmettons PrintSettings à Printer.ShowPrintDialog(), la boîte de dialogue s'ouvre avec l'orientation que nous avons prédéfinie. 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-configure landscape orientation for the dialog
var settings = new PrintSettings
{
    PaperOrientation = PaperOrientation.Landscape,
    PaperSize = PaperSize.Letter
};

// Open the dialog with pre-selected orientation
Printer.ShowPrintDialog("wide-report.pdf", settings);

Imports IronPrint

' Pre-configure landscape orientation for the dialog
Dim settings As New PrintSettings With {
    .PaperOrientation = PaperOrientation.Landscape,
    .PaperSize = PaperSize.Letter
}

' Open the dialog with pre-selected orientation
Printer.ShowPrintDialog("wide-report.pdf", settings)

Pour les scénarios d'interface utilisateur non bloquants, la variante asynchrone Printer.ShowPrintDialogAsync() accepte les mêmes paramètres et permet à l'application de rester réactive pendant que la boîte de dialogue est ouverte. 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-la à n'importe quelle méthode d'impression IronPrint. À combiner avec PaperSize, Dpi et PaperMargins pour un contrôle total de la mise en page.

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 $999.