GetDestName

Annotations and hotspot links, Destinations and actions

Description

Returns the name of a named destination handle or an explicit destination array that is stored in the document name tree

Function TPDFlib.GetDestName(DestID: Integer): WideString;

Function PDFlib::GetDestName(DestID As Long) As String

const wchar_t * DLGetDestName(int InstanceID, int DestID);

DestID	Destination handle returned by APIs such as GetActionDest, GetOpenActionDestination or GetNamedDestination

empty string	The handle is not a named destination and no matching name-tree entry was found
name	The destination name

For explicit destination arrays, the function searches the document name tree and returns the matching destination name when one exists