pdfResolveBookmarkDest

Purpose — Resolve a bookmark's destination page on demand, for bookmarks whose destination was deferred by a lazy import.

Description — With the lazy-content import flag (if2LazyContent) set, an imported bookmark may carry an unresolved destination — its target page is not computed at import time, and pdfGetBookmark reports DestPage as 0 while it is unresolved. This function looks the bookmark up by its handle, resolves the deferred destination against the import source — named destinations and integer-indexed destinations included — caches the result on the bookmark, and returns the destination page number. A bookmark whose destination is already resolved simply returns its cached page, so repeat calls for the same handle are cheap.

Parameters

Return value — The 1-based destination page number; 0 when the handle is unknown or the bookmark has no page destination.

Declarations

LPDF_API SI32 PDF_CALL pdfResolveBookmarkDest(PPDF IPDF, SI32 Handle);

function pdfResolveBookmarkDest(const IPDF: PPDF; Handle: Integer): Integer; stdcall; external 'LumasPdf.dll';

C# (P/Invoke)

public static extern int pdfResolveBookmarkDest(IntPtr IPDF, int Handle);