PageInfoLandscape Property

Returns true if the page orientation specified in the document for this page is landscape.

Namespace:  Aspose.Words.Rendering
Assembly:  Aspose.Words (in Aspose.Words.dll) Version: 21.11.0


public bool Landscape { get; }

Property Value

Type: Boolean


Shows how to print page size and orientation information for every page in a Word document.
Document doc = new Document(MyDir + "Rendering.docx");

// The first section has 2 pages. We will assign a different printer paper tray to each one,
// whose number will match a kind of paper source. These sources and their Kinds will vary
// depending on the installed printer driver.
PrinterSettings.PaperSourceCollection paperSources = new PrinterSettings().PaperSources;

doc.FirstSection.PageSetup.FirstPageTray = paperSources[0].RawKind;
doc.FirstSection.PageSetup.OtherPagesTray = paperSources[1].RawKind;

Console.WriteLine("Document \"{0}\" contains {1} pages.", doc.OriginalFileName, doc.PageCount);

float scale = 1.0f;
float dpi = 96;

for (int i = 0; i < doc.PageCount; i++)
    // Each page has a PageInfo object, whose index is the respective page's number.
    PageInfo pageInfo = doc.GetPageInfo(i);

    // Print the page's orientation and dimensions.
    Console.WriteLine($"Page {i + 1}:");
    Console.WriteLine($"\tOrientation:\t{(pageInfo.Landscape ? "Landscape" : "Portrait")}");
    Console.WriteLine($"\tPaper size:\t\t{pageInfo.PaperSize} ({pageInfo.WidthInPoints:F0}x{pageInfo.HeightInPoints:F0}pt)");
    Console.WriteLine($"\tSize in points:\t{pageInfo.SizeInPoints}");
    Console.WriteLine($"\tSize in pixels:\t{pageInfo.GetSizeInPixels(1.0f, 96)} at {scale * 100}% scale, {dpi} dpi");

    // Print the source tray information.
    PaperSource source = pageInfo.GetSpecifiedPrinterPaperSource(paperSources, paperSources[0]);
    Console.WriteLine($"\tSuitable print source:\t{source.SourceName}, kind: {source.Kind}");
Shows how to customize the printing of Aspose.Words documents.
Document doc = new Document(MyDir + "Rendering.docx");

    MyPrintDocument printDoc = new MyPrintDocument(doc);
    printDoc.PrinterSettings.PrintRange = System.Drawing.Printing.PrintRange.SomePages;
    printDoc.PrinterSettings.FromPage = 1;
    printDoc.PrinterSettings.ToPage = 1;


/// <summary>
/// Selects an appropriate paper size, orientation, and paper tray when printing.
/// </summary>
public class MyPrintDocument : PrintDocument
    public MyPrintDocument(Document document)
        mDocument = document;

    /// <summary>
    /// Initializes the range of pages to be printed according to the user selection.
    /// </summary>
    protected override void OnBeginPrint(PrintEventArgs e)

        switch (PrinterSettings.PrintRange)
            case System.Drawing.Printing.PrintRange.AllPages:
                mCurrentPage = 1;
                mPageTo = mDocument.PageCount;
            case System.Drawing.Printing.PrintRange.SomePages:
                mCurrentPage = PrinterSettings.FromPage;
                mPageTo = PrinterSettings.ToPage;
                throw new InvalidOperationException("Unsupported print range.");

    /// <summary>
    /// Called before each page is printed. 
    /// </summary>
    protected override void OnQueryPageSettings(QueryPageSettingsEventArgs e)

        // A single Microsoft Word document can have multiple sections that specify pages with different sizes, 
        // orientations, and paper trays. The .NET printing framework calls this code before 
        // each page is printed, which gives us a chance to specify how to print the current page.
        PageInfo pageInfo = mDocument.GetPageInfo(mCurrentPage - 1);
        e.PageSettings.PaperSize = pageInfo.GetDotNetPaperSize(PrinterSettings.PaperSizes);

        // Microsoft Word stores the paper source (printer tray) for each section as a printer-specific value.
        // To obtain the correct tray value, you will need to use the "RawKind" property, which your printer should return.
        e.PageSettings.PaperSource.RawKind = pageInfo.PaperTray;
        e.PageSettings.Landscape = pageInfo.Landscape;

    /// <summary>
    /// Called for each page to render it for printing. 
    /// </summary>
    protected override void OnPrintPage(PrintPageEventArgs e)

        // Aspose.Words rendering engine creates a page drawn from the origin (x = 0, y = 0) of the paper.
        // There will be a hard margin in the printer, which will render each page. We need to offset by that hard margin.
        float hardOffsetX, hardOffsetY;

        // Below are two ways of setting a hard margin.
        if (e.PageSettings != null && e.PageSettings.HardMarginX != 0 && e.PageSettings.HardMarginY != 0)
            // 1 -  Via the "PageSettings" property.
            hardOffsetX = e.PageSettings.HardMarginX;
            hardOffsetY = e.PageSettings.HardMarginY;
            // 2 -  Using our own values, if the "PageSettings" property is unavailable.
            hardOffsetX = 20;
            hardOffsetY = 20;

        mDocument.RenderToScale(mCurrentPage, e.Graphics, -hardOffsetX, -hardOffsetY, 1.0f);

        e.HasMorePages = mCurrentPage <= mPageTo;

    private readonly Document mDocument;
    private int mCurrentPage;
    private int mPageTo;

ExpandedSee Also