AddLinkToImportDataA
Annotazioni e collegamenti sensibili, campi modulo e AcroForm
Descrizione
Il suffisso A indica l'entry point DLL ANSI (char); l'interfaccia ActiveX/COM espone soltanto la forma Unicode. Il comportamento è identico a AddLinkToImportData e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode
Aggiunge alla pagina selezionata un rettangolo sensibile al clic che attiva un'azione PDF di importazione dati. Un'azione di importazione dati compila i campi AcroForm del documento da un file Forms Data Format (FDF) su disco. L'azione è definita in ISO 32000-1 §12.6.4.8, Table 198
Uso tipico: un collegamento “Ricarica dati di esempio” o “Ripristina impostazioni predefinite” in un modulo interattivo, nel quale il file FDF viene distribuito insieme al PDF e contiene i valori canonici dei campi
Usare la funzione SetAnnotBorderColor per cambiare il colore del bordo dell'area sensibile
Sintassi
Delphi
Function DLAddLinkToImportDataA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName: PAnsiChar; Options: Integer): Integer;DLL
int DLAddLinkToImportDataA(int InstanceID, double Left, double Top, double Width, double Height, const char * FileName, int Options);Parametri
| Left | La coordinata orizzontale del bordo sinistro del rettangolo hotspot |
|---|---|
| Top | La coordinata verticale del bordo superiore del rettangolo hotspot |
| Width | La larghezza del rettangolo hotspot |
| Height | L'altezza del rettangolo hotspot |
| FileName | Percorso del file FDF dal quale verranno compilati i campi del modulo. Le barre inverse vengono convertite in barre normali secondo la forma canonica dei percorsi PDF definita da ISO 32000-1 §7.11.2.1. Non è necessario che il file esista al momento della creazione del PDF, ma deve essere presente al momento della visualizzazione affinché l'azione riesca |
| Options | Maschera di bit dell'aspetto del collegamento. Bit 0 (1): bordo. Bit 1–3: evidenziazione (2 = Invert, 4 = Outline, 8 = Push); senza bit usa Invert. Stessa convenzione di AddLinkToWeb / AddLinkToHideField |
Note
NON consentito in PDF/A perché l'azione fa riferimento a una risorsa esterna. Quando il documento è in modalità PDF/A, la funzione restituisce silenziosamente 0 e non viene aggiunta alcuna annotazione. È richiesto PDF 1.4 o successivo