SetOutlineRemoteDestination

Marcadores

Descrição

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

O número da página de abertura e vários valores de dimensionamento/posicionamento podem ser especificados

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

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 conforme retornado pela função NewOutline. Alternativamente, use a função GetOutlineID para obter um ID de marcador válido

FileName

O nome do arquivo do documento PDF a abrir quando o marcador for clicado. Deve estar em um formato específico. As barras invertidas devem ser convertidas em barras normais e a unidade, se houver, deve ser indicada apenas pela letra da unidade entre barras, sem dois-pontos. Por exemplo, o arquivo "c:\my documents\hello.pdf" deve ser indicado como "/c/my documents/hello.pdf". Nomes de caminho relativos são válidos, inclusive caminhos com o operador ".." para subir um diretório

OpenPage

O número da página para saltar quando o documento de destino for aberto. A primeira página tem índice zero (0)

Zoom

A porcentagem de zoom a usar quando o documento for aberto, valores válidos de 0 a 6400. Usado apenas para DestType = 1; deve ser definido como 0 para os 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 porcentagem de zoom

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

3 = "FitH" - a página é ampliada para que toda a largura da página fique 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 para 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 para que um determinado retângulo da página fique visível. Os parâmetros Left, Top, Right e Bottom definem a área retangular na página

6 = "FitB" - a página é ampliada para que sua bounding box fique visível

7 = "FitBH" - a página é posicionada verticalmente na posição especificada pelo parâmetro Top. A página é ampliada para que toda a largura da bounding box da página fique visível

8 = "FitBV" - a página é posicionada na posição horizontal especificada pelo parâmetro Left. O zoom é ajustado apenas o suficiente para caber toda a altura da bounding box na janela

PntLeft

A posição horizontal usada por DestType = 1, 4, 5 e 8. A posição é especificada em pontos medidos do canto inferior esquerdo da página do documento de destino

PntTop

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

PntRight

A posição horizontal da borda direita do retângulo. Usada por DestType = 5. A posição é especificada em pontos medidos do canto inferior esquerdo da página do documento de destino

PntBottom

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

NewWindow

0 = Substitui o documento atual pelo documento de destino

1 = Abre o documento de destino em uma nova janela, a menos que o usuário tenha especificado preferência diferente no visualizador de PDF

Valores retornados