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 cadeia de caracteres são interpretados com base na página de código atual definida por SetAnsiMode

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