AddLinkToHideFieldA
Annotaties en hotspot-koppelingen, Formuliervelden en AcroForms
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 AddLinkToHideField en stringargumenten worden geïnterpreteerd volgens de huidige SetAnsiMode-codepagina
Voegt een klikbare hotspotrechthoek toe aan de geselecteerde pagina die bij activatie een PDF hide-actie triggert. Een hide-actie schakelt de zichtbaarheid van een of meer AcroForm-velden om, zodat dynamisch tonen/verbergen zonder JavaScript kan. De actie is gedefinieerd in ISO 32000-1 §12.6.4.10, Table 196
Typisch gebruik: een “Show details”/“Hide details”-koppeling in een formulierlayout, of groepen velden die elkaar uitsluiten waarbij één klik op de koppeling de ene groep verbergt en de andere toont (combineer twee AddLinkToHideField-aanroepen met tegenovergestelde HideFlag-waarden)
Gebruik de functie SetAnnotBorderColor om de kleur van de hotspotrand te wijzigen
Syntaxis
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);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 |
| FieldNames | Eén of meer volledig gekwalificeerde AcroForm-veldnamen, gescheiden door komma's, puntkomma's of regeleinden. Witruimte aan begin en einde van elke naam wordt getrimd. Een enkele naam schrijft /T als tekststring; twee of meer schrijven /T als array van tekststrings |
| HideFlag | Kiest de zichtbaarheidsrichting. Een waarde ongelijk aan nul verbergt de genoemde velden (/H true). Nul toont ze (/H false) |
| 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. Dezelfde conventie als AddLinkToWeb / AddLinkToNamedAction |
Opmerkingen
De annotatie is PDF/A-compatibel omdat er geen externe resource wordt gerefereerd. PDF 1.2 of nieuwer is vereist