AddFileAttachment

Propiedades del documento

Descripción

Registra un archivo incrustado existente como adjunto a nivel de documento en el visor de PDF. Los lectores que exponen el panel Adjuntos muestran el título proporcionado y abren el archivo incrustado referenciado cuando el usuario lo selecciona

Llame primero a AddEmbeddedFile para copiar los bytes de archivo al documento y obtener el EmbeddedFileID. Después, AddFileAttachment agrega esa especificación de archivo al árbol de nombres /Names /EmbeddedFiles del Catalog sin duplicar los bytes incrustados

Comportamiento de versión de PDF: AddEmbeddedFile emite diccionarios de secuencia de archivo incrustado y de especificación de archivo, que requieren PDF 1.3. Registrar el archivo en el árbol de nombres /Names /EmbeddedFiles del nivel de documento requiere PDF 1.4. Si la versión actual del documento es inferior y la versión de guardado no está bloqueada, AddFileAttachment eleva automáticamente el documento a PDF 1.4 y registra /EmbeddedFiles name tree en AutoBumpedFeatures. Si quien llama bloquea una versión de guardado inferior, la puerta de compatibilidad rechaza el guardado con LastErrorCode 602

Sintaxis

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	El nombre del adjunto que se muestra en el visor y se usa como clave en el árbol de nombres `/EmbeddedFiles`. No debe estar vacío
EmbeddedFileID	El valor devuelto por AddEmbeddedFile

Valores devueltos

0	EmbeddedFileID no es válido, el título está vacío o no hay ningún documento activo
1	El archivo incrustado se registró como un adjunto de nivel de documento

Observaciones

Esta función crea una entrada de lista de archivos adjuntos a nivel de documento. Para colocar un icono o una zona activa en la que se pueda hacer clic en una página, use AddLinkToEmbeddedFile en su lugar. Para incorporar y registrar un archivo en una sola llamada, use EmbedFile

Véase también

AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount