ImageGear for C and C++ on Windows v19.4 - Updated
IG_PDF_action_create_destination
API Reference Guide > PDF Component API Reference > PDF Component Objects Reference > General Objects > HIG_PDF_ACTION > IG_PDF_action_create_destination

Creates a new action that takes the user to the specified destination view.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_PDF_action_create_destination(
        HIG_PDF_DOC hDoc,
        HIG_PDF_DESTINATION hDest,
        LPHIG_PDF_ACTION lphAction
);

Arguments:

Name Type Description
hDoc HIG_PDF_DOC The document in which the action is created and used.
hDest HIG_PDF_DESTINATION The destination.
lphAction LPHIG_PDF_ACTION The newly created action object.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

This function can only be used for destinations in the same document as the source document. Cross-document links must be built up from the base level, populating the Action dictionary for the GotoR action as described in Section 8.5.3 in the PDF Reference.