AddRelativeLinkToFileEx

Anotaciones y enlaces de zona activa

Descripción

Añade a la página seleccionada un rectángulo de zona interactiva en el que se puede hacer clic y que enlaza, mediante una ruta relativa, con una página y posición concretas de otro documento PDF. Utilice la función SetAnnotBorderColor para cambiar el color del borde de la zona

El enlace al documento de destino solo utiliza el nombre de archivo. Esto significa que no se conocen las dimensiones de página del documento de destino, por lo que los parámetros DestLeft, DestTop, DestRight y DestBottom se especifican siempre en puntos medidos desde la esquina inferior izquierda del 'MediaBox de la página de destino'

Sintaxis

Delphi

Function TPDFlib.AddRelativeLinkToFileEx(Left, Top, Width, Height: Double; Const FileName: WideString; DestPage: Integer; NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight, DestBottom: Double): Integer;

ActiveX

Function PDFlib::AddRelativeLinkToFileEx(Left As Double, Top As Double, Width As Double, Height As Double, FileName As String, DestPage As Long, NewWindow As Long, Options As Long, Zoom As Long, DestType As Long, DestLeft As Double, DestTop As Double, DestRight As Double, DestBottom As Double) As Long

DLL

int DLAddRelativeLinkToFileEx(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int DestPage, int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

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

FileName

La ruta absoluta completa y el nombre de archivo del documento PDF con el que se enlazará; se convertirá en una ruta relativa

DestPage

La página del documento de destino a la que se enlazará

NewWindow

0 = Cerrar el documento actual y abrir después el nuevo documento

1 = Abrir el documento actual en una ventana nueva

Options

Especifica la apariencia del enlace:

0 = Sin borde

1 = Dibujar un borde

Porcentaje de zoom del objeto de destino, válido de 0 a 6400. Solo se utiliza para DestType = 1; para otros DestTypes debe ser 0

Zoom

DestType

1 = "XYZ" - la página de destino se coloca en el punto especificado por los parámetros Left y Top. El parámetro Zoom especifica el porcentaje de zoom

2 = "Fit" - toda la página se amplía para ajustarse a la ventana. No se utiliza ninguno de los demás parámetros y deben establecerse en cero

3 = "FitH": amplía para mostrar toda la anchura. La altura puede diferir de la ventana y Top define la posición vertical

4 = "FitV" - la página se amplía para que pueda verse toda su altura. La anchura de la página puede ser mayor o menor que la de la ventana. La página se coloca en la posición horizontal especificada por el parámetro Left

5 = "FitR": se amplía la página para mostrar un rectángulo definido por los parámetros Left, Top, Right y Bottom

6 = "FitB" - la página se amplía para que sea visible su 'cuadro delimitador'

7 = "FitBH" - la página se coloca verticalmente en la posición especificada por Top. El zoom se ajusta para que sea visible toda la anchura del cuadro delimitador de la página (‘cuadro delimitador de la página')

8 = "FitBV": coloca la página en la posición horizontal Left y aplica el zoom justo para ajustar toda la altura del cuadro delimitador

DestLeft

La posición horizontal utilizada por DestType = 1, 4, 5 y 8

DestTop

La posición vertical utilizada por DestType = 1, 3, 5 y 7

DestRight

La posición horizontal del borde derecho del rectángulo. Utilizada por DestType = 5

DestBottom

La posición horizontal de la parte inferior del rectángulo. Utilizada por DestType = 5

int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

Height: Double; FileName: WideString; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight,