com.pdf_tools.fourheights.pdftoolbox.pdf.navigation

Class FitWidthDestination

java.lang.Object

com.pdf_tools.fourheights.pdftoolbox.internal.NativeBase

com.pdf_tools.fourheights.pdftoolbox.internal.NativeObject

com.pdf_tools.fourheights.pdftoolbox.pdf.navigation.Destination

com.pdf_tools.fourheights.pdftoolbox.pdf.navigation.DirectDestination

com.pdf_tools.fourheights.pdftoolbox.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 and Description
static FitWidthDestination	create(Document targetDocument, Page page, boolean fitActualContent) Create a new FitWidthDestination
static FitWidthDestination	createDynamicObject(long handle)
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.

Methods inherited from class com.pdf_tools.fourheights.pdftoolbox.pdf.navigation.DirectDestination

getPage

Methods inherited from class com.pdf_tools.fourheights.pdftoolbox.pdf.navigation.Destination

getTarget

Methods inherited from class com.pdf_tools.fourheights.pdftoolbox.internal.NativeObject

equals, hashCode

Methods inherited from class java.lang.Object

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

Method Detail

createDynamicObject

public static FitWidthDestination createDynamicObject(long handle)

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 is null

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 page argument is null.

java.lang.IllegalArgumentException - If the page argument is already closed.

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.