AddLinkToNamedAction
Anotaciones y enlaces de zona activa, propiedades de página
Descripción
Agrega un rectángulo de zona activa seleccionable a la página elegida que activa una acción con nombre de PDF. Las acciones con nombre son comandos de navegación controlados por el visor definidos en ISO 32000-1 §12.6.4.11, Tabla 194. Los cuatro nombres estándar compatibles son NextPage, PrevPage, FirstPage y LastPage. A diferencia de AddLinkToPage, no se requiere un número de página de destino explícito — el visor interpreta el comando en tiempo de ejecución
Uso típico: botones de navegación (Siguiente / Anterior / Inicio / Fin) en el encabezado o pie de página, donde el destino es relativo a la página que el visor muestra actualmente
Use la función SetAnnotBorderColor para cambiar el color del borde de la zona activa
Sintaxis
Delphi
Function TPDFlib.AddLinkToNamedAction(Left, Top, Width, Height: Double; NamedActionType: Integer; Options: Integer): Integer;DLL
int DLAddLinkToNamedAction(int InstanceID, double Left, double Top, double Width, double Height, int NamedActionType, 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 |
| NamedActionType | Selecciona la acción nombrada que se activará: 0 = NextPage, 1 = PrevPage, 2 = FirstPage, 3 = LastPage; los valores fuera de este intervalo vuelven a NextPage para que el escritor siempre emita un nombre /N conforme a la especificación |
| Options | Máscara de bits que controla la apariencia del vínculo. 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 se establece ningún bit de resaltado, Invert se usa de forma predeterminada. Misma convención que AddLinkToWeb / AddLinkToPage |
Observaciones
La anotación es compatible con PDF/A porque no se hace referencia a recursos externos. Se requiere PDF 1.1 o posterior