AddFileAttachmentA
Propriedades do documento
Descrição
O sufixo A indica o ponto de entrada ANSI (char) da DLL; a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de AddFileAttachment e os argumentos de cadeia de caracteres são interpretados com base na página de código atual definida por SetAnsiMode
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 DLAddFileAttachmentA(InstanceID: Integer; Title: PAnsiChar; EmbeddedFileID: Integer): Integer;DLL
int DLAddFileAttachmentA(int InstanceID, const char * 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