SetOutlineRemoteDestinationA

Marcadores

Descrição

O sufixo A indica o ponto de entrada ANSI (char) da DLL; a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de SetOutlineRemoteDestination e os argumentos de string são interpretados usando a página de código atual definida por SetAnsiMode

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 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

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