[]
        
(Showing Draft Content)

GrapeCity.Documents.Pdf.Destination

Destination Class

The abstract base class for types representing a destination that defines a particular view of a document. A destination consists of:

  • The page of the document to be displayed.
  • The location of the document window on that page.
  • The magnification (zoom factor) to use when displaying the page.

Important note about vertical coordinates:

In PDFs, all coordinates are specified relative to the bottom left corner, with the Y axis going up. GcPdf uses the more common coordinate system with the origin in the top left corner, with the Y axis going down. In most situations the Y coordinates are automatically converted by GcPdf. In classes derived from Destination this is also done if the destination's target page is specified as the Page object. But if the destination's target page is specified by index, automatic conversion of the Y coordinate cannot be done, and it should be specified relative to the bottom left corner as per the PDF spec.

When the Y coordinate is specified relative to the page bottom, it is noted in the parameter's description. (It is recommended that constructors accepting a Page object are used instead.)

All properties defining the Y coordinate has linked property with "Pdf" prefix, for example Y and PdfY, the property with "Pdf" prefix contains a value relative to the bottom left corner with the Y axis going up.

Implements
Namespace: GrapeCity.Documents.Pdf
Assembly: DS.Documents.Pdf.dll
Syntax
public abstract class Destination : DestinationBase, IPdfArray, IDestination
Public MustInherit Class Destination
    Inherits DestinationBase
    Implements IPdfArray, IDestination

Properties

Name Description
Page

Gets this destination's target Page object. Returns null if the target page was specified by index.

PageIndex

Gets the index of this destination's target page. Returns null if the target page was specified as a Page object.

Note that if this property is not null, then any Y coordinate is relative to the bottom left corner (see Destination description for details).

PdfObject

Gets the underlying GrapeCity.Documents.Pdf.Spec.IPdfObject.

Extension Methods