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

0El OutlineID no era válido
1El destino del esquema se estableció correctamente double PntBottom, int NewWindow);