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
| Title | O nome do anexo apresentado no visualizador e utilizado como chave na árvore de nomes /EmbeddedFiles. Não pode estar vazio |
|---|---|
| EmbeddedFileID | O valor devolvido por AddEmbeddedFile |
Valores devolvidos
| 0 | O EmbeddedFileID é inválido, o título está vazio ou não existe nenhum documento ativo |
|---|---|
| 1 | O 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