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,