AddRelativeLinkToFileExA

Annotations and hotspot links

Descrição

The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to AddRelativeLinkToFileEx and string arguments are interpreted using the current SetAnsiMode code page

Adiciona à página selecionada um retângulo de hotspot clicável que aponta, por caminho relativo, para uma página e posição específicas em outro documento PDF. Use a função SetAnnotBorderColor para alterar a cor da borda do hotspot

O link para o documento de destino é feito apenas pelo nome do arquivo. Isso significa que as dimensões da página do documento de destino não são conhecidas, de modo que os parâmetros DestLeft, DestTop, DestRight e DestBottom são sempre especificados em pontos medidos do canto inferior esquerdo do MediaBox da página de destino

Sintaxe

Delphi

Function DLAddRelativeLinkToFileExA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName: PAnsiChar; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight, DestBottom: Double): Integer;

DLL

int DLAddRelativeLinkToFileExA(int InstanceID, double Left, double Top, double Width, double Height, const char * FileName, int DestPage, int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

Parâmetros

Left

A coordenada horizontal da borda esquerda do retângulo do hotspot

Top

A coordenada vertical da borda superior do retângulo do hotspot

Width

A largura do retângulo do hotspot

Height

A altura do retângulo do hotspot

FileName

O caminho absoluto completo e o nome do arquivo do documento PDF para onde o link aponta; será convertido em caminho relativo

DestPage

A página do documento de destino para onde o link aponta

NewWindow

0 = Fecha o documento atual e abre o novo documento

1 = Abre o documento atual em uma nova janela

Options

Especifica a aparência do link:

0 = No border

1 = Draw a border

A porcentagem de zoom a usar para o objeto de destino, valores válidos de 0 a 6400. Usado apenas para DestType = 1, deve ser definido como 0 para os outros DestTypes

Zoom

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

DestLeft

A posição horizontal usada por DestType = 1, 4, 5 e 8

DestTop

A posição vertical usada por DestType = 1, 3, 5 e 7

DestRight

A posição horizontal da borda direita do retângulo. Usada por DestType = 5

DestBottom

A posição horizontal da parte inferior do retângulo. Usada por DestType = 5

int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

Height: Double; FileName: WideString; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight,