AddLinkToNamedDestinationA
Anotaciones y enlaces de zona activa, propiedades de página
Descripción
La A final indica el punto de entrada DLL ANSI (char); la interfaz ActiveX/COM solo expone la forma Unicode. El comportamiento es idéntico al de AddLinkToNamedDestination y los argumentos de cadena se interpretan mediante la página de códigos actual de SetAnsiMode
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 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 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 |
| DestName | El destino con nombre al que se debe 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 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
| 0 | DestName estaba vacío o no se pudo crear el vínculo |
|---|---|
| 1 | El 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