AddLinkToSubmitForm
Anotaciones y enlaces de zona activa, Campos de formulario y AcroForms
Descripción
Añade un rectángulo de zona activa en la página seleccionada que activa una acción de envío de formulario PDF al pulsarlo. Esta acción envía los valores de los campos de AcroForm a una URL o punto final de procesamiento de formularios sin necesidad de JavaScript
Use FieldNames para restringir los campos enviados. Deje FieldNames vacío para que el visor envíe todos los campos aplicables
Use la función SetAnnotBorderColor para cambiar el color del borde de la zona activa
Sintaxis
Delphi
Function TPDFlib.AddLinkToSubmitForm(Left, Top, Width, Height: Double; Const URL, FieldNames: WideString; Flags, Options: Integer): Integer;DLL
int DLAddLinkToSubmitForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * URL, const wchar_t * FieldNames, int Flags, 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 |
| URL | La URL de destino de envío almacenada en la especificación de archivo de la acción |
| FieldNames | Lista opcional de nombres de campo AcroForm completos separados por comas, punto y coma o saltos de línea. Los espacios en blanco iniciales y finales de cada nombre se eliminan |
| Flags | Indicadores de la acción de envío de formulario PDF escritos en la entrada /Flags de la acción. Pase 0 para el envío en formato FDF predeterminado. Los bits estándar habituales son 4 para formato HTML, 32 para XFDF y 256 para enviar el documento PDF completo |
| Options | Máscara de bits que controla el aspecto 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 pulsar (2 = Invertir, 4 = Contorno, 8 = Hundir); si no se establece ningún bit de resaltado, se usa Invertir como valor predeterminado |
Valor de retorno
| 0 | La acción no se añadió porque el documento está en modo PDF/A, el rectángulo no es válido o URL está vacía |
|---|---|
| 1 | La anotación de enlace y la acción de envío de formulario se añadieron correctamente |
Observaciones
El modo PDF/A bloquea esta acción porque puede referenciar un destino de envío externo. La función requiere PDF 1.2 o posterior