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

LeftLa coordenada horizontal del borde izquierdo del rectángulo de zona activa
TopLa coordenada vertical del borde superior del rectángulo de zona activa
WidthLa anchura del rectángulo de zona activa
HeightLa altura del rectángulo de zona activa
FieldNamesLista 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
FlagsIndicadores 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
OptionsMá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

0La 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
1La 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