AddLinkToHideField
Anteckningar och hotspot-länkar, formulärfält och AcroForms
Beskrivning
Lägger till en klickbar hotspot-rektangel på den valda sidan som utlöser en PDF-Hide-åtgärd när den aktiveras. En Hide-åtgärd växlar synligheten för ett eller flera AcroForm-fält, vilket ger dynamiskt visa/dölj-beteende utan JavaScript. Åtgärden definieras i ISO 32000-1 §12.6.4.10, Table 196
Typisk användning: en länk “Visa detaljer” / “Dölj detaljer” i ett formulärlayout, eller ömsesidigt uteslutande fältgrupper där ett klick på en länk döljer en grupp och visar en annan (kombinera två AddLinkToHideField-anrop med motsatta
HideFlag-värden)Använd funktionen SetAnnotBorderColor för att ändra färgen på hotspot-kantlinjen
Syntax
Delphi
Function TPDFlib.AddLinkToHideField(Left, Top, Width, Height: Double; Const FieldNames: WideString; HideFlag: Integer; Options: Integer): Integer;DLL
int DLAddLinkToHideField(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FieldNames, int HideFlag, int Options);Parametrar
| Left | Den horisontella koordinaten för hotspot-rektangelns vänstra kant |
|---|---|
| Top | Den vertikala koordinaten för hotspot-rektangelns övre kant |
| Width | Bredden på hotspot-rektangeln |
| Height | Höjden på hotspot-rektangeln |
| FieldNames | Ett eller flera fullt kvalificerade AcroForm-fältnamn, separerade med kommatecken, semikolon eller radbrytningar. Inledande och avslutande blanktecken runt varje namn tas bort. Ett enskilt namn skriver /T som en textsträng; två eller flera skriver /T som en matris av textsträngar. |
| HideFlag | Väljer synlighetsriktningen. Ett värde skilt från noll döljer de listade fälten (/H true). Noll visar dem (/H false). |
| Options | Bitmask som styr länkens utseende. Bit 0 (värde 1): rita en kantlinje runt hotspot-rektangeln. Bit 1–3 väljer överstrykningsläget vid klick (2 = Invert, 4 = Outline, 8 = Push); när ingen överstrykningsbit är satt används Invert som standard. Samma konvention som AddLinkToWeb / AddLinkToNamedAction. |
Anmärkningar
PDF/A- och PDF/X-6-lägena avvisar Hide-åtgärder och returnerar 0; PDF 1.2 eller senare krävs