AddLinkToEmbeddedPDFA

Adnotacje i łącza obszarów aktywnych

Opis

Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w AddLinkToEmbeddedPDF, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

Dodaje do wybranej strony łącze w obszarze aktywnym, które otwiera dokument PDF osadzony w bieżącym pliku i przechodzi do wskazanej w nim strony. Łącze zawiera osadzoną akcję przejścia (/GoToE) zgodnie z ISO 32000-1 §12.6.4.4: jej łańcuch docelowy wskazuje osadzony plik (nazwę przekazaną do EmbedFile) w drzewie nazw EmbeddedFiles dokumentu's, a miejsce docelowe dopasowuje stronę docelową do okna.

Ponieważ /GoToE wprowadzono w PDF 1.6, wywołanie tej funkcji w razie potrzeby podnosi wersję dokumentu do 1.6. Użyj GetAnnotActionInfo, aby odczytać takie akcje: zgłasza ona rodzaj akGoToE wraz z nazwą osadzonego celu, relacją nadrzędny/podrzędny oraz flagą /NewWindow.

Składnia

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, HeightPołożenie i rozmiar obszaru aktywnego na wybranej stronie.
EmbeddedFileNameNazwa osadzonego pliku w drzewie nazw EmbeddedFiles dokumentu's, przekazana do EmbedFile (na przykład "report.pdf").
TargetPage1-bazowy numer strony w osadzonym dokumencie, do której należy przejść.
NewWindow1 = poproś przeglądarkę o otwarcie osadzonego dokumentu w nowym oknie, 0 = ustawienie domyślne przeglądarki.
Options1 = narysuj obramowanie wokół obszaru aktywnego, 0 = bez obramowania.

Wartości zwracane

0Nie można dodać łącza (pusta nazwa lub nieprawidłowa strona)
1Powodzenie