AddLinkToEmbeddedFile

Propriedades do documento, Anotações e links de zona ativa

Descrição

Adiciona um retângulo de anotação FileAttachment à página selecionada e o vincula a um arquivo embutido já armazenado no documento

Chame AddEmbeddedFile primeiro para copiar os bytes do arquivo para o PDF e obter o EmbeddedFileID. AddLinkToEmbeddedFile cria a anotação de página, grava o título do anexo e o conteúdo do popup e aponta a anotação para essa especificação de arquivo embutido.

Comportamento de versão do PDF: anotações FileAttachment e embedded file streams exigem PDF 1.3. A aparência da anotação gerada por esta função pode incluir opacidade de anotação via /CA e recursos de transparência, que exigem PDF 1.4. Se a versão atual do documento for menor e a versão de salvamento não estiver travada, AddLinkToEmbeddedFile eleva automaticamente o documento para PDF 1.4 e registra /CA annotation opacity em AutoBumpedFeatures. Se o chamador travar uma versão de salvamento menor, o gate de compatibilidade rejeita o salvamento 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 borda esquerda do retângulo da anotação.
Top	A coordenada vertical da borda 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 retornado por AddEmbeddedFile.
Title	O título do anexo exibido pelo visualizador de PDF.
Contents	O texto exibido no popup da anotação.
IconType	O ícone da anotação: 0 = PushPin, 1 = imagem de disco, 2 = sem ícone, 3 = gráfico, 4 = clipe de papel, 5 = tag, 6 = retângulo branco sólido.
Transparency	A porcentagem de transparência de 0 a 100. Zero é totalmente opaco; 100 deixa o ícone invisível.

Valores retornados

0	O EmbeddedFileID é inválido, nenhuma página está selecionada ou nenhum documento está ativo.
1	A anotação FileAttachment foi criada com sucesso.

Veja também

AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount