PageInfo

Inheritance: java.lang.Object

public class PageInfo

Represents information about a particular document page.

To learn more, visit the Rendering documentation article.

Remarks:

The page width and height returned by this object represent the “final” size of the page e.g. they are already rotated to the correct orientation.

Methods

MethodDescription
getColored()Returns true if the page contains colored content.
getHeightInPoints()Gets the height of the page in points.
getLandscape()Returns true if the page orientation specified in the document for this page is landscape.
getPaperSize()Gets the paper size as enumeration.
getPaperTray()Gets the paper tray (bin) for this page as specified in the document.
getSizeInPixels(float scale, float dpi)Calculates the page size in pixels for a specified zoom factor and resolution.
getSizeInPixels(float scale, float horizontalDpi, float verticalDpi)Calculates the page size in pixels for a specified zoom factor and resolution.
getSizeInPoints()Gets the page size in points.
getWidthInPoints()Gets the width of the page in points.

getColored()

public boolean getColored()

Returns true if the page contains colored content.

Examples:

Shows how to check whether the page is in color or not.


 Document doc = new Document(getMyDir() + "Document.docx");

 // Check that the first page of the document is not colored.
 Assert.assertFalse(doc.getPageInfo(0).getColored());
 

Returns: boolean - true if the page contains colored content.

getHeightInPoints()

public float getHeightInPoints()

Gets the height of the page in points.

Returns: float - The height of the page in points.

getLandscape()

public boolean getLandscape()

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

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

getPaperSize()

public int getPaperSize()

Gets the paper size as enumeration.

Returns: int - The paper size as enumeration. The returned value is one of PaperSize constants.

getPaperTray()

public int getPaperTray()

Gets the paper tray (bin) for this page as specified in the document. The value is implementation (printer) specific.

Returns: int - The paper tray (bin) for this page as specified in the document.

getSizeInPixels(float scale, float dpi)

public Dimension getSizeInPixels(float scale, float dpi)

Calculates the page size in pixels for a specified zoom factor and resolution.

Parameters:

ParameterTypeDescription
scalefloatThe zoom factor (1.0 is 100%).
dpifloatThe resolution (horizontal and vertical) to convert from points to pixels (dots per inch).

Returns: java.awt.Dimension - The size of the page in pixels.

getSizeInPixels(float scale, float horizontalDpi, float verticalDpi)

public Dimension getSizeInPixels(float scale, float horizontalDpi, float verticalDpi)

Calculates the page size in pixels for a specified zoom factor and resolution.

Parameters:

ParameterTypeDescription
scalefloatThe zoom factor (1.0 is 100%).
horizontalDpifloatThe horizontal resolution to convert from points to pixels (dots per inch).
verticalDpifloatThe vertical resolution to convert from points to pixels (dots per inch).

Returns: java.awt.Dimension - The size of the page in pixels.

getSizeInPoints()

public Point2D.Float getSizeInPoints()

Gets the page size in points.

Returns: java.awt.geom.Point2D.Float - The page size in points.

getWidthInPoints()

public float getWidthInPoints()

Gets the width of the page in points.

Returns: float - The width of the page in points.