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

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

The PaperOrientation property on PrintSettings accepts three values:

• PaperOrientation.Portrait — disposition verticale (par défaut sur la plupart des imprimantes). Idéal pour les documents à colonne unique comme les lettres, contrats et factures.
• PaperOrientation.Landscape — disposition 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 réglage par défaut de l'imprimante.

Nous créons un objet PrintSettings, attribuons l'orientation désirée, et le passons à Printer.Print() pour l'impression silencieuse ou à Printer.ShowPrintDialog() pour l' 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 un booléen (DefaultPageSettings.Landscape = true) enfoui à l'intérieur d'une PrintDocument qui nécessite également la gestion des é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 — définir l'A4 en paysage donne une surface d'impression de 297 × 210 mm, tandis que l'A4 en portrait donne 210 × 297 mm. La propriété Dpi contrôle la résolution de sortie (300 est standard pour les documents professionnels), et les valeurs PaperMargins sont en millimètres.

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

Quand nous passons PrintSettings à Printer.ShowPrintDialog(), la boîte de dialogue s'ouvre avec notre orientation 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 garde l'application 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 à Portrait, Landscape, ou Automatic et passez-le à n'importe quelle méthode d'impression IronPrint. Combinez-le avec PaperSize, Dpi, et PaperMargins pour un contrôle complet 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.