AddLinkToImportDataA
Anotaciones y enlaces de zona activa, Campos de formulario y AcroForms
Descripción
La A final indica el punto de entrada de DLL ANSI (char); la interfaz ActiveX/COM solo expone la forma Unicode. El comportamiento es idéntico a AddLinkToImportData y los argumentos de cadena se interpretan con la página de códigos SetAnsiMode actual
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 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);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 | El ancho del rectángulo de zona activa |
| Height | La altura del rectángulo de zona activa |
| FileName | Ruta del archivo FDF con el que se rellenarán los campos de formulario. Las barras inversas se convierten en barras normales conforme al formato de ruta canónico de PDF de ISO 32000-1 §7.11.2.1. No es necesario que el archivo exista al crear el PDF, pero debe estar disponible al visualizarlo para que la acción se complete correctamente |
| Options | Máscara de apariencia. Bit 0: borde. Bits 1–3: resaltado (2 = Invert, 4 = Outline, 8 = Push); sin bit usa Invert. Igual que AddLinkToWeb / AddLinkToHideField |
Observaciones
NO se permite en PDF/A porque la acción hace referencia a un recurso externo. Cuando el documento está en modo PDF/A, la función devuelve silenciosamente 0 y no se añade ninguna anotación. Se requiere PDF 1.4 o posterior