AddLinkToHideField

Anotaciones y enlaces de zona activa, campos de formulario y AcroForms

Descripción

Agrega un rectángulo de zona activa en el que se puede hacer clic a la página seleccionada y activa una acción de ocultar PDF al activarse. Una acción de ocultar alterna la visibilidad de uno o más campos AcroForm, lo que permite un comportamiento dinámico de mostrar u ocultar sin JavaScript. La acción se define en ISO 32000-1 §12.6.4.10, Tabla 196

Uso típico: un vínculo “Mostrar detalles” / “Ocultar detalles” en un diseño de formulario, o grupos de campos mutuamente excluyentes donde al hacer clic en un vínculo se oculta un grupo y se muestra otro, combinando dos llamadas AddLinkToHideField con valores HideFlag opuestos

Use la función SetAnnotBorderColor para cambiar el color del borde de la zona activa

Sintaxis

Delphi

Function TPDFlib.AddLinkToHideField(Left, Top, Width, Height: Double; Const FieldNames: WideString; HideFlag: Integer; Options: Integer): Integer;

DLL

int DLAddLinkToHideField(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FieldNames, int HideFlag, int Options);

Parámetros

LeftLa coordenada horizontal del borde izquierdo del rectángulo de la zona activa
TopLa coordenada vertical del borde superior del rectángulo de la zona activa
WidthEl ancho del rectángulo de la zona activa
HeightEl alto del rectángulo de la zona activa
FieldNamesUno o más 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. Un solo nombre emite /T como cadena de texto; dos o más emiten /T como una matriz de cadenas de texto
HideFlagSelecciona la dirección de la visibilidad. Un valor distinto de cero oculta los campos indicados (/H true). Cero los muestra (/H false)
OptionsMáscara de bits que controla la apariencia del enlace. Bit 0 (valor 1): dibujar un borde alrededor del rectángulo de la zona activa. Los bits 1–3 seleccionan el modo de resaltado al hacer clic (2 = Invert, 4 = Outline, 8 = Push); cuando no se establece ningún bit de resaltado, se usa Invert como valor predeterminado. Misma convención que AddLinkToWeb / AddLinkToNamedAction

Observaciones

Los modos PDF/A y PDF/X-6 rechazan las acciones Hide y devuelven 0; se requiere PDF 1.2 o posterior