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
| Left | La coordenada horizontal del borde izquierdo del rectángulo de la zona activa |
|---|---|
| Top | La coordenada vertical del borde superior del rectángulo de la zona activa |
| Width | El ancho del rectángulo de la zona activa |
| Height | El alto del rectángulo de la zona activa |
| FieldNames | Uno 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 |
| HideFlag | Selecciona la dirección de la visibilidad. Un valor distinto de cero oculta los campos indicados (/H true). Cero los muestra (/H false) |
| Options | Má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