AddLinkToNamedDestination
Anmerkungen und Hotspot-Links, Seiteneigenschaften
Beschreibung
Fügt der ausgewählten Seite ein anklickbares Hotspot-Rechteck hinzu, das zu einem benannten Ziel im selben PDF-Dokument springt. Registrieren Sie das Ziel zunächst mit NewDestination und NewNamedDestination und erstellen Sie anschließend Hotspots, die auf den stabilen Zielnamen verweisen, statt eine Seitennummer und ein Ziel-Array zu duplizieren.
Referenzseite für AddLinkToNamedDestination; die Funktion gehört zu Annotations and hotspot links, Page properties und behält alle Bezeichner exakt wie gezeigt bei
Syntax
Delphi
Function TPDFlib.AddLinkToNamedDestination(Left, Top, Width, Height: Double; Const DestName: WideString; Options: Integer): Integer;DLL
int DLAddLinkToNamedDestination(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * DestName, int Options);Parameter
| Left | Die horizontale Koordinate des linken Randes des Hotspot-Rechtecks |
|---|---|
| Top | Die vertikale Koordinate des oberen Randes des Hotspot-Rechtecks |
| Width | Die Breite des Hotspot-Rechtecks |
| Height | Die Höhe des Hotspot-Rechtecks |
| DestName | Das benannte Ziel, zu dem gesprungen werden soll. Der Name sollte bereits im Namensbaum des Dokuments vorhanden sein, normalerweise über NewNamedDestination |
| Options | Bitmaske zur Steuerung des Link-Erscheinungsbilds. Bit 0 (Wert 1): Rahmen um das Hotspot-Rechteck zeichnen. Die Bits 1–3 wählen den Hervorhebungsmodus beim Klicken (2 = Invert, 4 = Outline, 8 = Push); ist kein Hervorhebungsbit gesetzt, wird standardmäßig Invert verwendet |
Rückgabewerte
| 0 | DestName war leer oder der Link konnte nicht erstellt werden |
|---|---|
| 1 | Der Link zum benannten Ziel wurde der ausgewählten Seite hinzugefügt |
Siehe auch
Die Linkanmerkung schreibt eine GoTo-Aktion, deren Ziel die Zeichenfolge des benannten Ziels ist. Dadurch bleiben Hotspots stabil, wenn Seiten eingefügt oder verschoben werden, nachdem das benannte Ziel erstellt wurde.