AddLinkToEmbeddedPDFA
Anotações e ligações de áreas interativas
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 AddLinkToEmbeddedPDF e os argumentos de cadeia de caracteres são interpretados com base na página de código atual definida por SetAnsiMode
Adiciona à página selecionada uma ligação de zona ativa que abre um documento PDF incorporado no ficheiro atual e salta para uma página desse documento. A ligação contém uma ação de ida para incorporado (/GoToE), em conformidade com ISO 32000-1 §12.6.4.4: a respetiva cadeia de destino identifica o ficheiro incorporado (o nome transmitido a EmbedFile) na árvore de nomes d'EmbeddedFiles do documento, e o destino ajusta a página de destino à janela
Uma vez que /GoToE foi introduzido com PDF 1.6, a chamada desta função eleva a versão do documento para 1.6 quando necessário. Utilize GetAnnotActionInfo para voltar a ler essas ações: comunica o tipo akGoToE juntamente com o nome do destino incorporado, a relação principal/descendente e o sinalizador /NewWindow
Sintaxe
Delphi
Function DLAddLinkToEmbeddedPDFA(InstanceID: Integer; Left, Top, Width, Height: Double; EmbeddedFileName: PAnsiChar; TargetPage, NewWindow, Options: Integer): Integer;
DLL
int DLAddLinkToEmbeddedPDFA(int InstanceID, double Left, double Top, double Width, double Height, const char * EmbeddedFileName, int TargetPage, int NewWindow, int Options);
Parâmetros
| Left, Top, Width, Height | A posição e o tamanho da área sensível na página selecionada |
|---|---|
| EmbeddedFileName | O nome do ficheiro incorporado na árvore de nomes EmbeddedFiles do documento's, tal como passado a EmbedFile (por exemplo, "report.pdf") |
| TargetPage | A página baseada em 1 do documento incorporado para a qual saltar |
| NewWindow | 1 = solicita ao visualizador que abra o documento incorporado numa nova janela, 0 = predefinição do visualizador |
| Options | 1 = desenha um contorno em torno da área interativa, 0 = sem contorno |
Valores devolvidos
| 0 | Não foi possível adicionar a ligação (nome vazio ou página inválida) |
|---|---|
| 1 | Success |