Package com.pdftools.toolbox.pdf.navigation

Class FitWidthDestination

java.lang.Object

com.pdftools.toolbox.internal.NativeBase

com.pdftools.toolbox.internal.NativeObject

com.pdftools.toolbox.pdf.navigation.Destination

com.pdftools.toolbox.pdf.navigation.DirectDestination

com.pdftools.toolbox.pdf.navigation.FitWidthDestination

public class FitWidthDestination
extends DirectDestination

A destination fits the width of a page into the viewport.

Note: Many PDF viewers support different viewing modes like "fit page" or "fit width". A FitWidthDestination will change the current viewing mode to "fit width" in those viewers.

Changing the viewing mode is usually not very well received by users and thus a LocationZoomDestination should be preferred in most cases.

Method Summary

Modifier and Type	Method	Description
static FitWidthDestination	create(Document targetDocument, Page page, boolean fitActualContent)	Create a new FitWidthDestination
static FitWidthDestination	create(Document targetDocument, Page page, boolean fitActualContent, java.lang.Double top)	Create a new FitWidthDestination
boolean	getFitActualContent()	If true, the viewport is fitted to the width of the actual content of the page, instead of the width of the page.
java.lang.Double	getTop()	The location of the page that is displayed at the top of the viewport (if possible).

Methods inherited from class com.pdftools.toolbox.pdf.navigation.DirectDestination

getPage

Methods inherited from class com.pdftools.toolbox.pdf.navigation.Destination

getTarget

Methods inherited from class com.pdftools.toolbox.internal.NativeObject

equals, hashCode

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static FitWidthDestination create(Document targetDocument,
                                         Page page,
                                         boolean fitActualContent)

Create a new FitWidthDestination

The returned object is not yet used on any page, but it is associated with the given target document.

Parameters:

targetDocument - The output document with which the returned object is associated

page - The page in the document that this destination is pointing to.

fitActualContent -

If true, the viewport is fitted to the actual content of the page, instead of the size of the page.

See property getFitActualContent() for more information.

Returns:

The newly created destination object.

Throws:

java.lang.IllegalArgumentException - if the targetDocument argument has already been closed

java.lang.IllegalArgumentException - if the targetDocument argument is read-only

java.lang.IllegalArgumentException - if the targetDocumentdiffers from the document associated with page

java.lang.IllegalArgumentException - If the document associated with the page argument has already been closed.

java.lang.IllegalArgumentException - if targetDocument is null

java.lang.IllegalArgumentException - if page is null

create

public static FitWidthDestination create(Document targetDocument,
                                         Page page,
                                         boolean fitActualContent,
                                         java.lang.Double top)

Create a new FitWidthDestination

The returned object is not yet used on any page, but it is associated with the given target document.

Parameters:

targetDocument - The output document with which the returned object is associated

page - The page in the document that this destination is pointing to.

fitActualContent -

If true, the viewport is fitted to the actual content of the page, instead of the size of the page.

See property getFitActualContent() for more information.

top - The location of the page that is displayed at the top of the viewport or null. See property getTop() for more information.

Returns:

The newly created destination object.

Throws:

java.lang.IllegalArgumentException - if the targetDocument argument has already been closed

java.lang.IllegalArgumentException - if the targetDocument argument is read-only

java.lang.IllegalArgumentException - if the targetDocumentdiffers from the document associated with page

java.lang.IllegalArgumentException - If the document associated with the page argument has already been closed.

java.lang.IllegalArgumentException - if targetDocument is null

java.lang.IllegalArgumentException - if page is null

getFitActualContent

public boolean getFitActualContent()

If true, the viewport is fitted to the width of the actual content of the page, instead of the width of the page.

Note: Many PDF viewers simply ignore this property and always treat it as false, i.e. switching to "fit page" mode anyway.

Throws:

java.lang.IllegalStateException - the object has already been closed.

java.lang.IllegalStateException - the associated document has already been closed.

getTop

public java.lang.Double getTop()

The location of the page that is displayed at the top of the viewport (if possible).

If the property is null, the value from before the jump is retained.

Throws:

java.lang.IllegalStateException - the object has already been closed.

java.lang.IllegalStateException - the associated document has already been closed.