AddLinkToEmbeddedPDFA
Anmerkungen und Hotspot-Links
Beschreibung
Das angehängte A bezeichnet den ANSI-Einstiegspunkt (char) der DLL; die ActiveX/COM-Oberfläche stellt nur die Unicode-Variante bereit. Das Verhalten ist identisch mit AddLinkToEmbeddedPDF, und Zeichenkettenargumente werden anhand der aktuellen SetAnsiMode-Codepage interpretiert
Fügt der ausgewählten Seite einen Hotspot-Link hinzu, der ein im aktuellen Dokument eingebettetes PDF öffnet und dort zu einer Seite springt. Der Link enthält eine eingebettete Go-to-Aktion (/GoToE) nach ISO 32000-1 §12.6.4.4: Seine Zielkette benennt die eingebettete Datei (den an EmbedFile übergebenen Namen) im EmbeddedFiles-Namensbaum des Dokuments', und das Ziel passt die Zielseite in das Fenster ein.
Da /GoToE mit PDF 1.6 eingeführt wurde, hebt der Aufruf dieser Funktion die Dokumentversion bei Bedarf auf 1.6 an. Verwenden Sie GetAnnotActionInfo, um solche Aktionen zurückzulesen: Die Funktion meldet den Typ akGoToE zusammen mit dem Namen des eingebetteten Ziels, der Eltern-/Kindbeziehung und dem Flag /NewWindow
Syntax
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);Parameter
| Left, Top, Width, Height | Position und Größe des Hotspot-Bereichs auf der ausgewählten Seite |
|---|---|
| EmbeddedFileName | Der Name der eingebetteten Datei im EmbeddedFiles-Namensbaum des Dokuments', wie an EmbedFile übergeben (beispielsweise "report.pdf") |
| TargetPage | Die auf 1 basierende Seite im eingebetteten Dokument, zu der gesprungen werden soll |
| NewWindow | 1 = den Viewer auffordern, das eingebettete Dokument in einem neuen Fenster zu öffnen, 0 = Viewer-Standard. |
| Options | 1 = einen Rahmen um den Hotspot zeichnen, 0 = kein Rahmen. |
Rückgabewerte
| 0 | Der Link konnte nicht hinzugefügt werden (leerer Name oder ungültige Seite) |
|---|---|
| 1 | Success |