AddLinkToNamedDestination

Anotaciones y enlaces de zona activa, propiedades de página

Descripción

Agrega un rectángulo de zona activa seleccionable a la página seleccionada que salta a un destino con nombre en el mismo documento PDF Use NewDestination y NewNamedDestination para registrar primero el destino y luego cree zonas activas que hagan referencia al nombre de destino estable en lugar de duplicar un número de página y un arreglo de destino

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

Sintaxis

Delphi

Function TPDFlib.AddLinkToNamedDestination(Left, Top, Width, Height: Double; Const DestName: WideString; Options: Integer): Integer;

DLL

int DLAddLinkToNamedDestination(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * DestName, int Options);

Parámetros

LeftLa coordenada horizontal del borde izquierdo del rectángulo activo
TopLa coordenada vertical del borde superior del rectángulo activo
WidthEl ancho del rectángulo activo
HeightLa altura del rectángulo activo
DestNameEl destino con nombre al que se debe saltar. El nombre ya debe existir en el árbol de nombres del documento, normalmente mediante NewNamedDestination
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 se establece ningún bit de resaltado, se usa Invert de forma predeterminada

Valores devueltos

0DestName estaba vacío o no se pudo crear el vínculo
1El vínculo al destino con nombre se agregó a la página seleccionada

Observaciones

La anotación de vínculo escribe una acción GoTo cuyo destino es la cadena de destino con nombre. Esto mantiene estables las zonas activas cuando se insertan o mueven páginas después de crear el destino con nombre