SetOutlineRemoteDestination

Marcadores

Descrição

Define o item de contorno (marcador) para abrir outro PDF quando é clicado

É possível especificar o número da página inicial e vários valores de dimensionamento e posicionamento

Nota: como o tamanho da página do documento de destino não é conhecido, todas as posições são especificadas em pontos medidos a partir do canto inferior esquerdo da página inicial

Sintaxe

Delphi

Function TPDFlib.SetOutlineRemoteDestination(OutlineID: Integer; Const FileName: WideString; OpenPage, Zoom, DestType: Integer; PntLeft, PntTop, PntRight, PntBottom: Double; NewWindow: Integer): Integer;

ActiveX

Function PDFlib::SetOutlineRemoteDestination(OutlineID As Long, FileName As String, OpenPage As Long, Zoom As Long, DestType As Long, PntLeft As Double, PntTop As Double, PntRight As Double, PntBottom As Double, NewWindow As Long) As Long

DLL

int DLSetOutlineRemoteDestination(int InstanceID, int OutlineID, const wchar_t * FileName, int OpenPage, int Zoom, int DestType, double PntLeft, double PntTop, double PntRight, double PntBottom, int NewWindow);

Parâmetros

OutlineID

O ID do marcador devolvido pela função NewOutline. Em alternativa, utilize a função GetOutlineID para obter um ID de marcador válido

FileName

O nome do ficheiro do documento PDF a abrir quando o marcador é clicado. Deve ter um formato específico. As barras invertidas devem ser convertidas em barras normais e a unidade, caso exista, deve ser especificada apenas pela respetiva letra entre barras normais, sem dois pontos. Por exemplo, o ficheiro "c:\my documents\hello.pdf" deve ser especificado como "/c/my documents/hello.pdf". Os nomes de caminhos relativos são válidos, incluindo caminhos que utilizem o operador ".." para subir um diretório

OpenPage

O número da página para a qual avançar quando o documento de destino é aberto. A primeira página tem o índice zero (0)

Zoom

A percentagem de zoom a utilizar ao abrir o documento, com valores válidos de 0 a 6400. Utilizada apenas para DestType = 1; deve ser definida como 0 para outros DestTypes

DestType

1 = "XYZ" - a página de destino é posicionada no ponto especificado pelos parâmetros Left e Top. O parâmetro Zoom especifica a percentagem de zoom

2 = "Fit" - a página inteira é ampliada para caber na janela. Nenhum dos outros parâmetros é utilizado e devem ser definidos como zero

3 = "FitH" - a página é ampliada de modo que toda a largura da página seja visível. A altura da página pode ser maior ou menor que a altura da janela. A página é posicionada na posição vertical especificada pelo parâmetro Top

4 = "FitV" - a página é ampliada de modo que toda a altura da página possa ser vista. A largura da página pode ser maior ou menor que a largura da janela. A página é posicionada na posição horizontal especificada pelo parâmetro Left

5 = "FitR" - a página é ampliada de modo que um determinado retângulo na página seja visível. Os parâmetros Left, Top, Right e Bottom definem a área retangular na página

6 = "FitB" - a página é ampliada de modo que a sua caixa delimitadora seja visível

7 = "FitBH" - a página é posicionada verticalmente na posição especificada pelo parâmetro Top. A página é ampliada de modo que toda a largura da caixa delimitadora da página seja visível

8 = "FitBV" - a página é posicionada na posição horizontal especificada pelo parâmetro Left. A página é ampliada apenas o suficiente para caber toda a altura da caixa delimitadora na janela

PntLeft

A posição horizontal utilizada por DestType = 1, 4, 5 e 8. A posição é especificada em pontos medidos a partir do canto inferior esquerdo d'uma página do documento de destino

PntTop

A posição vertical utilizada por DestType = 1, 3, 5 e 7. A posição é especificada em pontos medidos a partir do canto inferior esquerdo da página d'o documento de destino

PntRight

A posição horizontal da extremidade direita do retângulo. Utilizada por DestType = 5. A posição é especificada em pontos medidos a partir do canto inferior esquerdo da página d'o documento de destino

PntBottom

A posição horizontal da parte inferior do retângulo. Utilizada por DestType = 5. A posição é especificada em pontos medidos a partir do canto inferior esquerdo da página 'do documento de destino'

NewWindow

0 = Substituir o documento atual pelo documento de destino

1 = Abrir o documento de destino numa nova janela, a menos que o utilizador tenha especificado uma preferência diferente no visualizador de PDF

Valores devolvidos