AddLinkToSubmitFormA
Anotaciones y vínculos activos, Campos de formulario y AcroForms
Descripción
La A final indica el punto de entrada ANSI (char) de la DLL; la interfaz ActiveX/COM expone únicamente la forma Unicode. El comportamiento es idéntico a AddLinkToSubmitForm y los argumentos de cadena se interpretan utilizando la página de códigos actual de SetAnsiMode
Agrega un rectángulo activo clicable a la página seleccionada que activa una acción de envío de formulario PDF al ser activado. Una acción de envío de formulario envía los valores de los campos AcroForm a una URL o punto 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 del área activa
Sintaxis
Delphi
Function DLAddLinkToSubmitFormA(InstanceID: Integer; Left, Top, Width, Height: Double; URL, FieldNames: PAnsiChar; Flags, Options: Integer): Integer;DLL
int DLAddLinkToSubmitFormA(int InstanceID, double Left, double Top, double Width, double Height, const char * URL, const char * FieldNames, int Flags, int Options);Parámetros
| Left | La coordenada horizontal del borde izquierdo del rectángulo activo |
|---|---|
| Top | La coordenada vertical del borde superior del rectángulo activo |
| Width | El ancho del rectángulo activo |
| Height | La altura del rectángulo activo |
| 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 campos AcroForm completamente calificados, separados por comas, punto y coma o saltos de línea. Los espacios al inicio y al final de cada nombre se eliminan automáticamente |
| 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 predeterminado en estilo FDF. Los bits estándar comunes incluyen 4 para formato HTML, 32 para XFDF y 256 para enviar el documento PDF completo |
| Options | Máscara de bits que controla la apariencia del vínculo. Bit 0 (valor 1): dibuja un borde alrededor del rectángulo activo. Los bits 1-3 seleccionan el modo de resaltado al hacer clic (2 = Invertir, 4 = Contorno, 8 = Presionar); cuando no se establece ningún bit de resaltado, se usa Invertir como predeterminado |
Valores devueltos
| 0 | La acción no se agregó porque el documento está en modo PDF/A, el rectángulo no es válido, o URL está vacío |
|---|---|
| 1 | La anotación de vínculo y la acción de envío de formulario se agregaron correctamente |
Observaciones
El modo PDF/A bloquea esta acción porque puede hacer referencia a un destino de envío externo. La función requiere PDF 1.2 o posterior