AddFileAttachment

Propriedades do documento

Descrição

Regista um ficheiro incorporado existente como anexo ao nível do documento no visualizador de PDF. Os leitores que apresentam o painel Anexos mostram o título fornecido e abrem o ficheiro incorporado referenciado quando o utilizador o seleciona

Invoque primeiro AddEmbeddedFile para copiar os bytes do ficheiro para o documento e obter o EmbeddedFileID. Em seguida, AddFileAttachment adiciona essa especificação de ficheiro à árvore de nomes /Names /EmbeddedFiles do Catalog sem duplicar os bytes incorporados

Comportamento da versão do PDF: AddEmbeddedFile emite dicionários de fluxos de ficheiros incorporados e de especificações de ficheiros, que requerem PDF 1.3. O registo do ficheiro na árvore de nomes /Names /EmbeddedFiles ao nível do documento requer PDF 1.4. Se a versão atual do documento for inferior e a versão de gravação não estiver bloqueada, AddFileAttachment eleva automaticamente o documento para PDF 1.4 e regista /EmbeddedFiles name tree 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.AddFileAttachment(Const Title: WideString; EmbeddedFileID: Integer): Integer;

ActiveX

Function PDFlib::AddFileAttachment(Title As String, EmbeddedFileID As Long) As Long

DLL

int DLAddFileAttachment(int InstanceID, const wchar_t * Title, int EmbeddedFileID);

Parâmetros

TitleO nome do anexo apresentado no visualizador e utilizado como chave na árvore de nomes /EmbeddedFiles. Não pode estar vazio
EmbeddedFileIDO valor devolvido por AddEmbeddedFile

Valores devolvidos

0O EmbeddedFileID é inválido, o título está vazio ou não existe nenhum documento ativo
1O ficheiro incorporado foi registado como anexo ao nível do documento

Observações

Esta função cria uma entrada de lista de anexos ao nível do documento. Para colocar um ícone ou uma zona ativa clicável numa página, utilize antes AddLinkToEmbeddedFile. Para incorporar e registar um ficheiro numa única chamada, utilize EmbedFile

Consulte também

AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount