AddLinkToNamedDestinationA

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

Descripción

La A final indica el punto de entrada de DLL ANSI (char); la interfaz ActiveX/COM solo expone la forma Unicode. El comportamiento es idéntico a AddLinkToNamedDestination y los argumentos de cadena se interpretan con la página de códigos SetAnsiMode actual

Añade un rectángulo que salta a un destino con nombre del mismo PDF. Regístrelo con NewDestination y NewNamedDestination y referencie su nombre estable

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

Sintaxis

Delphi

Function DLAddLinkToNamedDestinationA(InstanceID: Integer; Left, Top, Width, Height: Double; DestName: PAnsiChar; Options: Integer): Integer;

DLL

int DLAddLinkToNamedDestinationA(int InstanceID, double Left, double Top, double Width, double Height, const char * DestName, 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
DestName	El destino con nombre al que se saltará. El nombre ya debe existir en el árbol de nombres del documento, normalmente mediante NewNamedDestination
Options	Má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 pulsar (2 = Invert, 4 = Outline, 8 = Push); cuando no se establece ningún bit de resaltado, se utiliza Invert como valor predeterminado

Valores devueltos

0	DestName estaba vacío o no se pudo crear el enlace
1	El enlace de destino con nombre se ha añadido a la página seleccionada

Observaciones

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