AddLinkToEmbeddedFile

Propriedades do documento, anotações e ligações de zonas interativas

Descrição

Adiciona um retângulo de anotação FileAttachment à página selecionada e liga-o a um ficheiro incorporado já guardado no documento

Chame primeiro AddEmbeddedFile para copiar os bytes do ficheiro para o PDF e obter o EmbeddedFileID. AddLinkToEmbeddedFile cria a anotação da página, escreve o título do anexo e o conteúdo da janela de contexto e aponta a anotação para essa especificação de ficheiro incorporado

Comportamento da versão do PDF: as anotações FileAttachment e os fluxos de ficheiros incorporados requerem PDF 1.3. A aparência da anotação gerada por esta função pode incluir opacidade da anotação através de /CA e recursos de transparência, que requerem PDF 1.4. Se a versão atual do documento for inferior e a versão de gravação não estiver bloqueada, AddLinkToEmbeddedFile eleva automaticamente o documento para PDF 1.4 e regista /CA annotation opacity em AutoBumpedFeatures. Se o chamador bloquear uma versão de gravação inferior, a verificação de compatibilidade rejeita a gravação com LastErrorCode 602

Sintaxe

Delphi

Function TPDFlib.AddLinkToEmbeddedFile(Left, Top, Width, Height: Double; EmbeddedFileID: Integer; Const Title, Contents: WideString; IconType, Transparency: Integer): Integer;

ActiveX

Function PDFlib::AddLinkToEmbeddedFile(Left As Double, Top As Double, Width As Double, Height As Double, EmbeddedFileID As Long, Title As String, Contents As String, IconType As Long, transpareny As Long) As Long

DLL

int DLAddLinkToEmbeddedFile(int InstanceID, double Left, double Top, double Width, double Height, int EmbeddedFileID, const wchar_t * Title, const wchar_t * Contents, int IconType, int transpareny);

Parâmetros

Left	A coordenada horizontal da extremidade esquerda do retângulo da anotação
Top	A coordenada vertical da margem superior do retângulo da anotação
Width	A largura do retângulo da anotação
Height	A altura do retângulo da anotação
EmbeddedFileID	O valor devolvido por AddEmbeddedFile
Title	O título do anexo apresentado pelo visualizador de PDF
Contents	O texto apresentado na janela de contexto da anotação
IconType	O ícone da anotação: 0 = PushPin, 1 = imagem de disco, 2 = sem ícone, 3 = gráfico, 4 = clipe, 5 = etiqueta, 6 = retângulo branco sólido
Transparency	A percentagem de transparência de 0 a 100. Zero é totalmente opaco; 100 torna o ícone invisível

Valores devolvidos

0	O EmbeddedFileID é inválido, não está selecionada nenhuma página ou não existe um documento ativo
1	A anotação FileAttachment foi criada com êxito

Consulte também

AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount