AddLinkToNamedDestinationA
Annotaties en hotspotkoppelingen, pagina-eigenschappen
Beschrijving
De afsluitende A geeft het ANSI (char)-DLL-entrypoint aan; het ActiveX/COM-oppervlak biedt alleen de Unicode-vorm. Het gedrag is identiek aan AddLinkToNamedDestination en stringargumenten worden geïnterpreteerd volgens de huidige SetAnsiMode-codepagina
Voegt een klikbare hotspotrechthoek toe aan de geselecteerde pagina die naar een named destination in hetzelfde PDF-document springt. Registreer eerst het doel met NewDestination en NewNamedDestination en maak daarna hotspots die naar die stabiele bestemmingsnaam verwijzen, in plaats van een paginanummer en bestemmingsarray telkens te dupliceren
Gebruik de functie SetAnnotBorderColor om de kleur van de hotspotrand te wijzigen
Syntaxis
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);Parameters
| Left | De horizontale coördinaat van de linkerrand van de hotspot-rechthoek |
|---|---|
| Top | De verticale coördinaat van de bovenrand van de hotspot-rechthoek |
| Width | De breedte van de hotspot-rechthoek |
| Height | De hoogte van de hotspot-rechthoek |
| DestName | De named destination waarnaar wordt gesprongen. De naam moet al in de naamboom van het document bestaan, meestal via NewNamedDestination |
| Options | Bitmasker dat het uiterlijk van de link bepaalt. Bit 0 (waarde 1): teken een rand om de hotspotrechthoek. Bits 1–3 kiezen de klikaccentmodus (2 = Invert, 4 = Outline, 8 = Push); als geen accentbit is gezet, wordt Invert als standaard gebruikt |
Retourwaarden
| 0 | DestName was leeg of de link kon niet worden aangemaakt |
|---|---|
| 1 | De named-destination-link is aan de geselecteerde pagina toegevoegd |
Opmerkingen
De linkannotatie schrijft een GoTo-actie waarvan de bestemming de named-destination-string is. Zo blijven hotspots stabiel wanneer pagina's worden ingevoegd of verplaatst nadat de named destination is aangemaakt