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, Height | Położenie i rozmiar obszaru aktywnego na wybranej stronie. |
|---|---|
| EmbeddedFileName | Nazwa osadzonego pliku w drzewie nazw EmbeddedFiles dokumentu's, przekazana do EmbedFile (na przykład "report.pdf"). |
| TargetPage | 1-bazowy numer strony w osadzonym dokumencie, do której należy przejść. |
| NewWindow | 1 = poproś przeglądarkę o otwarcie osadzonego dokumentu w nowym oknie, 0 = ustawienie domyślne przeglądarki. |
| Options | 1 = narysuj obramowanie wokół obszaru aktywnego, 0 = bez obramowania. |
Wartości zwracane
| 0 | Nie można dodać łącza (pusta nazwa lub nieprawidłowa strona) |
|---|---|
| 1 | Powodzenie |