AddLinkToNamedAction
Anotaciones y enlaces de zona activa, propiedades de página
Descripción
Añade a la página seleccionada un rectángulo de zona activa en el que se puede hacer clic y que desencadena una acción PDF con nombre al activarse. Las acciones con nombre son comandos de navegación controlados por el visor y definidos en ISO 32000-1 §12.6.4.11, Table 194. Los cuatro nombres estándar compatibles son NextPage, PrevPage, FirstPage y LastPage. A diferencia de AddLinkToPage, no se necesita un número explícito de página de destino — el visor interpreta el comando en tiempo de ejecución
Uso habitual: botones de navegación (Siguiente / Anterior / Inicio / Fin) en un encabezado o pie de página, donde el destino es relativo a la página que muestra actualmente el visor
Utilice 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 de zona activa |
|---|---|
| Top | La coordenada vertical del borde superior del rectángulo de zona activa |
| Width | El ancho del rectángulo de zona activa |
| Height | La altura del rectángulo de zona activa |
| NamedActionType | Selecciona la acción: 0 = NextPage, 1 = PrevPage, 2 = FirstPage, 3 = LastPage. Otros valores usan NextPage para emitir un nombre /N válido |
| Options | Máscara de apariencia. Bit 0: borde. Bits 1–3: resaltado (2 = Invert, 4 = Outline, 8 = Push); sin bit usa Invert. Igual que AddLinkToWeb / AddLinkToPage |
Observaciones
La anotación es compatible con PDF/A porque no hace referencia a ningún recurso externo. Se requiere PDF 1.1 o posterior