NewDestination
Anotações e links de zona ativa, Gerenciamento de documentos
Descrição
Cria um novo objeto de destino que pode ser usado com as funções AddLinkToDestination, GetDestPage, GetDestType ou GetDestValue
Sintaxe
Delphi
Function TPDFlib.NewDestination(DestPage, Zoom, DestType: Integer; Left, Top, Right, Bottom: Double): Integer;
ActiveX
Function PDFlib::NewDestination(DestPage As Long, Zoom As Long, DestType As Long, Left As Double, Top As Double, Right As Double, Bottom As Double) As Long
DLL
int DLNewDestination(int InstanceID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);
Parâmetros
| DestPage | O número da página para a qual este objeto de destino aponta |
|---|---|
| Zoom | 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 |
| DestType | 1 = "XYZ" - a página alvo é 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 é ajustada ao tamanho da janela. Nenhum dos outros parâmetros é usado e deve ser definido como zero. 3 = "FitH" - a página é ajustada 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 é ajustada para que toda a altura da página fique visível. 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 é ajustada para que um certo retângulo da página fique visível. Os parâmetros Left, Top, Right e Bottom definem a área retangular da página. 6 = "FitB" - a página é ajustada 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 é ajustada 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. A página é ajustada o suficiente para caber toda a altura da bounding box na janela |
| Left | A posição horizontal usada por DestType = 1, 4, 5 e 8 |
| Top | A posição vertical usada por DestType = 1, 3, 5 e 7. A posição horizontal da borda direita do retângulo. Usada por DestType = 5 |
| Right | |
| Bottom | A posição horizontal da parte inferior do retângulo. Usada por DestType = 5 |
Valores retornados
| 0 | O parâmetro DestPage era inválido. Um valor de DestID |
|---|---|
| Non-zero |