AddLinkToNamedDestinationA
Adnotacje i łącza obszarów aktywnych, Właściwości strony
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 AddLinkToNamedDestination, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode
Dodaje do wybranej strony klikalny prostokątny obszar aktywny, który przechodzi do nazwanego miejsca docelowego w tym samym dokumencie PDF. Najpierw zarejestruj cel za pomocą NewDestination i NewNamedDestination, a następnie utwórz obszary aktywne odwołujące się do stabilnej nazwy miejsca docelowego zamiast powielać numer strony i tablicę miejsca docelowego.
Aby zmienić kolor obramowania obszaru aktywnego, użyj funkcji SetAnnotBorderColor
Składnia
Delphi
Function DLAddLinkToNamedDestinationA(InstanceID: Integer; Left, Top, Width, Height: Double; DestName: PAnsiChar; Options: Integer): Integer;DLL
int DLAddLinkToNamedDestinationA(int InstanceID, double Left, double Top, double Width, double Height, const char * DestName, int Options);Parametry
| Left | Pozioma współrzędna lewej krawędzi prostokąta obszaru aktywnego |
|---|---|
| Top | Pionowa współrzędna górnej krawędzi prostokąta obszaru aktywnego |
| Width | Szerokość prostokąta obszaru aktywnego |
| Height | Wysokość prostokąta obszaru aktywnego |
| DestName | Nazwane miejsce docelowe, do którego należy przejść. Nazwa powinna już istnieć w drzewie nazw dokumentu, zwykle za pośrednictwem NewNamedDestination |
| Options | Maska bitowa sterująca wyglądem łącza. Bit 0 (wartość 1): narysuj obramowanie wokół prostokąta obszaru aktywnego. Bity 1–3 wybierają tryb wyróżnienia kliknięcia (2 = Invert, 4 = Outline, 8 = Push); gdy nie ustawiono żadnego bitu wyróżnienia, domyślnie używany jest Invert |
Wartości zwracane
| 0 | DestName było puste albo nie można było utworzyć łącza |
|---|---|
| 1 | Łącze do nazwanego miejsca docelowego zostało dodane do wybranej strony |
Uwagi
Adnotacja łącza zapisuje akcję GoTo, której celem jest ciąg nazwanego miejsca docelowego. Dzięki temu obszary aktywne pozostają stabilne po wstawieniu lub przeniesieniu stron już po utworzeniu nazwanego miejsca docelowego.