AddLinkToHideField
Annotaties en hotspotkoppelingen, formuliervelden en AcroForms
Beschrijving
Voegt een klikbare hotspotrechthoek toe aan de geselecteerde pagina die bij activatie een PDF-hide-actie start. Een hide-actie schakelt de zichtbaarheid van één of meer AcroForm-velden om, zodat dynamisch tonen/verbergen zonder JavaScript mogelijk wordt. De actie is gedefinieerd in ISO 32000-1 §12.6.4.10, Table 196
Typisch gebruik: een koppeling “Details tonen” / “Details verbergen” in een formulierlayout, of wederzijds exclusieve veldgroepen waarbij een klik op de ene koppeling de ene groep verbergt en de andere toont (combineer twee AddLinkToHideField-aanroepen met tegengestelde HideFlag-waarden)
Gebruik de functie SetAnnotBorderColor om de kleur van de hotsperrand te wijzigen
Syntaxis
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);Parameters
| Left | De horizontale coördinaat van de linkerrand van de hotspotrechthoek |
|---|---|
| Top | De verticale coördinaat van de bovenrand van de hotspotrechthoek |
| Width | De breedte van de hotspotrechthoek |
| Height | De hoogte van de hotspotrechthoek |
| FieldNames | Een of meer volledig gekwalificeerde AcroForm-veldnamen, gescheiden door komma's, puntkomma's of regeleindes. Witruimte aan begin en einde van elke naam wordt verwijderd. Een enkele naam schrijft /T als tekststring; twee of meer schrijven /T als een array van tekststrings. |
| HideFlag | Kiest de zichtbaarheidsrichting. Een waarde ongelijk nul verbergt de vermelde velden (/H true). Nul toont ze (/H false). |
| Options | Bitmasker dat de weergave van de koppeling bepaalt. Bit 0 (waarde 1): teken een rand rond de hotspotrechthoek. Bits 1–3 kiezen de klikmarkeringsmodus (2 = Invert, 4 = Outline, 8 = Push); wanneer geen markeringsbit is ingesteld, wordt Invert als standaard gebruikt. Dezelfde conventie als AddLinkToWeb / AddLinkToNamedAction. |
Opmerkingen
PDF/A- en PDF/X-6-modussen wijzen Hide-acties af en geven 0 terug; PDF 1.2 of hoger is vereist