AddLinkToEmbeddedPDFA
Anotace a hotspotové odkazy
Popis
Koncové A označuje vstupní bod ANSI (char) knihovny DLL; rozhraní ActiveX/COM zpřístupňuje pouze formu Unicode. Chování je shodné s AddLinkToEmbeddedPDF a řetězcové argumenty jsou interpretovány pomocí aktuální znakové stránky nastavené funkcí SetAnsiMode
Přidá na vybranou stránku odkaz aktivní oblasti, který otevře PDF dokument vložený v aktuálním souboru a skočí na jeho stránku. Odkaz nese vloženou akci go-to (/GoToE) dle ISO 32000-1 §12.6.4.4: cílový řetěz pojmenuje vložený soubor (název předaný funkci EmbedFile) ve stromu názvů EmbeddedFiles dokumentu a cíl přizpůsobí cílovou stránku oknu
Protože /GoToE přineslo až PDF 1.6, volání této funkce v případě potřeby zvýší verzi dokumentu na 1.6. Takové akce lze načíst zpět funkcí GetAnnotActionInfo: hlásí druh akce akGoToE spolu s názvem vloženého cíle, vztahem rodič/potomek a příznakem /NewWindow
Syntaxe
Delphi
Function DLAddLinkToEmbeddedPDFA(InstanceID: Integer; Left, Top, Width, Height: Double; EmbeddedFileName: PAnsiChar; TargetPage, NewWindow, Options: Integer): Integer;
DLL
int DLAddLinkToEmbeddedPDFA(int InstanceID, double Left, double Top, double Width, double Height, const char * EmbeddedFileName, int TargetPage, int NewWindow, int Options);
Parametry
| Left, Top, Width, Height | Pozice a velikost aktivní oblasti na vybrané stránce |
|---|---|
| EmbeddedFileName | Název vloženého souboru ve stromu názvů EmbeddedFiles dokumentu, jak byl předán funkci EmbedFile (například "report.pdf") |
| TargetPage | Stránka ve vloženém dokumentu, na kterou se má skočit, počítaná od 1 |
| NewWindow | 1 = požádat prohlížeč, aby otevřel vložený dokument v novém okně, 0 = výchozí chování prohlížeče |
| Options | 1 = vykreslit okraj kolem aktivní oblasti, 0 = bez okraje |
Návratové hodnoty
| 0 | Odkaz se nepodařilo přidat (prázdný název nebo neplatná stránka) |
|---|---|
| 1 | Success |