AddFileAttachment
Propriedades do documento
Descrição
Registra um arquivo embutido existente como anexo de nível de documento no visualizador de PDF. Leitores que expõem o painel Attachments mostram o título fornecido e abrem o arquivo embutido referenciado quando o usuário o seleciona
Chame AddEmbeddedFile primeiro para copiar os bytes do arquivo para o documento e obter o EmbeddedFileID. AddFileAttachment então adiciona essa especificação de arquivo à name tree /Names /EmbeddedFiles do Catalog sem duplicar os bytes embutidos.
Comportamento de versão do PDF: AddEmbeddedFile emite o embedded file stream e dicionários de especificação de arquivo, que exigem PDF 1.3. Registrar o arquivo na name tree /Names /EmbeddedFiles de nível de documento exige PDF 1.4. Se a versão atual do documento for menor e a versão de salvamento não estiver travada, AddFileAttachment eleva automaticamente o documento para PDF 1.4 e registra /EmbeddedFiles name tree 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.AddFileAttachment(Const Title: WideString; EmbeddedFileID: Integer): Integer;ActiveX
Function PDFlib::AddFileAttachment(Title As String, EmbeddedFileID As Long) As LongDLL
int DLAddFileAttachment(int InstanceID, const wchar_t * Title, int EmbeddedFileID);Parâmetros
| Title | O nome do anexo exibido no visualizador e usado como chave na name tree /EmbeddedFiles. Não pode ficar em branco. |
|---|---|
| EmbeddedFileID | O valor retornado por AddEmbeddedFile. |
Valores retornados
| 0 | O EmbeddedFileID é inválido, o título está em branco ou nenhum documento está ativo. |
|---|---|
| 1 | O arquivo embutido foi registrado como anexo de nível de documento. |
Observações
Esta função cria uma entrada na lista de anexos de nível de documento. Para colocar um ícone ou zona ativa clicável em uma página, use AddLinkToEmbeddedFile. Para embutir e registrar um arquivo em uma única chamada, use EmbedFile.
Veja também
AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount