AddLinkToResetForm
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 sobre el que se puede hacer clic y que desencadena una acción reset-form de PDF al activarse. Una acción reset-form restaura los campos de AcroForm a sus valores predeterminados sin necesidad de JavaScript Use
FieldNames para restringir los campos afectados por la acción de restablecimiento. Deje FieldNames vacío para que el visor restablezca todos los campos aplicables
Use la función
SetAnnotBorderColor para cambiar el color del borde de la zona activa
Sintaxis
Delphi
Function TPDFlib.AddLinkToResetForm(Left, Top, Width, Height: Double; Const FieldNames: WideString; Flags, Options: Integer): Integer;
DLL
int DLAddLinkToResetForm(int InstanceID, double Left, double Top, double Width, double Height, 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 | La anchura del rectángulo de zona activa |
| Height | La altura del rectángulo de zona activa |
| FieldNames | Lista opcional de nombres completos de campos de AcroForm separados por comas, punto y coma o saltos de línea. Los espacios en blanco al inicio y al final de cada nombre se recortan |
| Flags | Indicadores de la acción reset-form de PDF que se escriben en la entrada /Flags de la acción. Pase 0 para el comportamiento predeterminado. Los visores estándar usan los bits de indicador junto con /Fields para decidir si la lista es inclusiva o exclusiva |
| 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 |
Valores devueltos
| 0 | La acción no se añadió porque el documento está en modo PDF/A o PDF/X-6, o el rectángulo no es válido |
|---|---|
| 1 | La anotación de enlace y la acción reset-form se añadieron |
Observaciones
Los modos PDF/A y PDF/X-6 bloquean esta acción; la función requiere PDF 1.2 o posterior