AddLinkToImportData
Anotaciones y enlaces de zona activa, campos de formulario y AcroForms
Descripción
Añade a la página seleccionada un rectángulo de zona activa en el que se puede pulsar y que desencadena una acción de importación de datos PDF al activarse. Una acción de importación de datos rellena los campos 'AcroForm' del documento desde un archivo Forms Data Format (FDF) del disco. La acción se define en ISO 32000-1 §12.6.4.8, Tabla 198
Uso habitual: un enlace “Volver a cargar los datos de ejemplo” o “Restablecer los valores predeterminados” de un formulario interactivo, donde el archivo FDF se distribuye junto al PDF y contiene los valores canónicos de los campos
Utilice la función SetAnnotBorderColor para cambiar el color del borde de la zona activa
Sintaxis
Delphi
Function TPDFlib.AddLinkToImportData(Left, Top, Width, Height: Double; Const FileName: WideString; Options: Integer): Integer;DLL
int DLAddLinkToImportData(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int Options);Parámetros
| Left | La coordenada horizontal del borde izquierdo del rectángulo de zona activa |
|---|---|
| Top | La coordenada vertical del borde superior del rectángulo de zona activa |
| Width | La anchura del rectángulo de zona activa |
| Height | La altura del rectángulo de zona activa |
| FileName | La ruta al archivo FDF desde el que se rellenarán los campos del formulario. Las barras invertidas se convierten en barras normales según la forma canónica de ruta de PDF de ISO 32000-1 §7.11.2.1. El archivo no necesita existir en el momento de crear el PDF, pero debe estar presente al visualizarlo para que la acción tenga éxito. |
| Options | Máscara de bits que controla la apariencia del enlace. Bit 0 (valor 1): dibuja un borde alrededor del rectángulo de zona activa. Los bits 1–3 seleccionan el modo de resaltado al hacer clic (2 = Invert, 4 = Outline, 8 = Push); cuando no hay ningún bit de resaltado activado, se usa Invert como valor predeterminado. Misma convención que AddLinkToWeb / AddLinkToHideField. |
Observaciones
Los modos PDF/A y PDF/X-6 rechazan las acciones ImportData y devuelven 0 sin añadir una anotación; se requiere PDF 1.4 o posterior