API referenceCore SDK

pdfCreateGoToActionEx

Create a GoTo action targeting a previously created named

Purpose — Create a GoTo action targeting a previously created named destination, by handle.

Description — Registers action kind 0 directly with Dest=1 (the internal "named" marker) and the named-destination handle stored in the GotoPg slot — distinct from pdfCreateGoToAction, which targets an explicit page/coordinates. NamedDest must be a handle previously returned by pdfCreateNamedDest.

Declarations

C
int32_t __stdcall pdfCreateGoToActionEx(PPDF IPDF, uint32_t NamedDest);
Delphi
function pdfCreateGoToActionEx(const IPDF: PPDF; NamedDest: Cardinal): Integer; stdcall; external 'LumasPdf.dll';

Parameters

ParameterTypeDescription
IPDFPPDFInstance handle.
NamedDestCardinalHandle from pdfCreateNamedDest.

Return value — 1-based action handle (> 0) on success, 0 if the handle is invalid. The validity of NamedDest itself is not checked at this call — an out-of-range value is stored as-is and only matters at serialization.

See alsopdfCreateGoToAction, pdfCreateNamedDest

C# (P/Invoke)

wrappers/dotnet/LumasPdf.cs
public static extern int pdfCreateGoToActionEx(IntPtr IPDF, uint NamedDest);
Area
Core SDK
Category

Object Creation

Exported names

pdfCreateGoToActionEx

String variants

The …A form takes UTF-8, …W takes UTF-16; a bare name aliases the ANSI form.

See working code

Worked examples — complete programs in ten languages.