SetOutlineRemoteDestinationA
Marcadores
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 SetOutlineRemoteDestination y los argumentos de cadena se interpretan con la página de códigos SetAnsiMode actual
Configura el elemento del esquema (marcador) para que abra otro PDF al hacer clic en él
Se pueden especificar el número de la página inicial y diversos valores de tamaño y posición
Nota: como se desconoce el tamaño de página del documento de destino, todas las posiciones se expresan en puntos desde la esquina inferior izquierda de la página inicial
Sintaxis
Delphi
Function DLSetOutlineRemoteDestinationA(InstanceID, OutlineID: Integer; FileName: PAnsiChar; OpenPage, Zoom, DestType: Integer; PntLeft, PntTop, PntRight, PntBottom: Double; NewWindow: Integer): Integer;
DLL
int DLSetOutlineRemoteDestinationA(int InstanceID, int OutlineID, const char * FileName, int OpenPage, int Zoom, int DestType, double PntLeft, double PntTop, double PntRight, double PntBottom, int NewWindow);
Parámetros
OutlineID
ID del marcador devuelto por la función NewOutline. También puede utilizar GetOutlineID para obtener un ID de marcador válido
FileName
Nombre del PDF que se abrirá al pulsar. Convierta barras inversas en directas y escriba la unidad entre barras sin dos puntos; "c:\my documents\hello.pdf" pasa a "/c/my documents/hello.pdf". Admite rutas relativas y ".."
OpenPage
El número de página a la que se saltará al abrir el documento de destino. La primera página tiene el índice cero (0)
Zoom
El porcentaje de zoom que se utilizará al abrir el documento, con valores válidos de 0 a 6400. Solo se utiliza para DestType = 1; debe establecerse en 0 para otros DestTypes
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
PntLeft
Posición horizontal utilizada por DestType = 1, 4, 5 y 8. Se expresa en puntos desde la esquina inferior izquierda de la página de destino ('target')
PntTop
Posición vertical utilizada por DestType = 1, 3, 5 y 7. Se expresa en puntos desde la esquina inferior izquierda de la página de destino ('target')
PntRight
La posición horizontal del borde derecho del rectángulo. Utilizada por DestType = 5. Se especifica en puntos medidos desde la esquina inferior izquierda de la página del documento de destino (‘página del documento de destino')
PntBottom
Posición horizontal de la parte inferior del rectángulo. Se utiliza con 'DestType' = 5. La posición se especifica en puntos medidos desde la esquina inferior izquierda de la página del documento de destino
NewWindow
0 = Sustituir el documento actual por el documento de destino
1 = Abrir el documento de destino en una ventana nueva, salvo que el usuario haya especificado otra preferencia en el visor de PDF
Valores devueltos
| 0 | El OutlineID no era válido |
|---|---|
| 1 | El destino del esquema se estableció correctamente double PntBottom, int NewWindow); |