AddLinkToHideFieldA
Annotationer og hotspot-links, Formularfelter og AcroForms
Beskrivelse
Det afsluttende A angiver DLL-indgangspunktet for ANSI (char); ActiveX/COM-grænsefladen eksponerer kun Unicode-formen. Funktionsmåden er identisk med AddLinkToHideField, og strengargumenter fortolkes med den aktuelle SetAnsiMode-tegntabel
Tilføjer et klikbart hotspot-rektangel på den valgte side, som udløser en PDF-skjulehandling, når det aktiveres. En skjulehandling skifter synligheden af ét eller flere AcroForm-felter og muliggør dynamisk vis/skjul-funktionalitet uden JavaScript. Handlingen er defineret i ISO 32000-1 §12.6.4.10, Table 196.
Typisk brug: et link til “Vis detaljer” / “Skjul detaljer” i et formularlayout eller gensidigt udelukkende feltgrupper, hvor et klik på et link skjuler en gruppe og viser en anden (kombiner to AddLinkToHideField-kald med modsatte HideFlag-værdier).
Brug funktionen SetAnnotBorderColor til at ændre farven på hotspot-kanten.
Syntaks
Delphi
Function DLAddLinkToHideFieldA(InstanceID: Integer; Left, Top, Width, Height: Double; FieldNames: PAnsiChar; HideFlag, Options: Integer): Integer;DLL
int DLAddLinkToHideFieldA(int InstanceID, double Left, double Top, double Width, double Height, const char * FieldNames, int HideFlag, int Options);Parametre
| Left | Den vandrette koordinat for hotspot-rektanglets venstre kant |
|---|---|
| Top | Den lodrette koordinat for hotspot-rektanglets øverste kant |
| Width | Bredden af hotspot-rektanglet |
| Height | Højden af hotspot-rektanglet |
| FieldNames | Et eller flere fuldt kvalificerede AcroForm-feltnavne adskilt af kommaer, semikoloner eller linjeskift. Indledende og afsluttende mellemrum omkring hvert navn fjernes. Et enkelt navn udsender /T som en tekststreng; to eller flere udsender /T som et array af tekststrenge. |
| HideFlag | Vælger synlighedsretningen. En værdi forskellig fra nul skjuler de anførte felter (/H true). Nul viser dem (/H false). |
| Options | Bitmaske, der styrer linkets udseende. Bit 0 (værdi 1): Tegn en kant omkring hotspotrektanglet. Bit 1–3 vælger fremhævningstilstanden ved klik (2 = Invert, 4 = Outline, 8 = Push); når ingen fremhævningsbit er indstillet, bruges Invert som standard. Samme konvention som AddLinkToWeb / AddLinkToNamedAction |
Bemærkninger
Annoteringen er PDF/A-kompatibel, fordi der ikke refereres til nogen ekstern ressource. PDF 1.2 eller nyere er påkrævet.