AddFileAttachmentA
Propiedades del documento
Descripción
La A final indica el punto de entrada de DLL ANSI (char); la interfaz ActiveX/COM solo expone la forma Unicode. El comportamiento es idéntico a AddFileAttachment y los argumentos de cadena se interpretan con la página de códigos SetAnsiMode actual
Registra un archivo incrustado existente como archivo adjunto a nivel de documento en el visor PDF. Los lectores que exponen el panel Archivos 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 del archivo en el documento y obtener el EmbeddedFileID. A continuación, AddFileAttachment añade esa especificación de archivo al árbol de nombres /Names /EmbeddedFiles del Catalog sin duplicar los bytes incrustados
Comportamiento de versión PDF: AddEmbeddedFile emite diccionarios de flujo de archivo incrustado y especificación de archivo, que requieren PDF 1.3. Registrar el archivo en el árbol de nombres /Names /EmbeddedFiles a nivel de documento requiere PDF 1.4. Si la versión actual 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 el llamador bloquea una versión inferior, la puerta de compatibilidad rechaza el guardado con LastErrorCode 602
Sintaxis
Delphi
Function DLAddFileAttachmentA(InstanceID: Integer; Title: PAnsiChar; EmbeddedFileID: Integer): Integer;
DLL
int DLAddFileAttachmentA(int InstanceID, const char * Title, int EmbeddedFileID);
Parámetros
| Title | Nombre del archivo adjunto mostrado en el visor y utilizado como clave en el árbol de nombres /EmbeddedFiles. No debe estar vacío |
|---|---|
| EmbeddedFileID | El valor devuelto por AddEmbeddedFile |
Valores devueltos
| 0 | El EmbeddedFileID no es válido, el título está vacío o no hay ningún documento activo |
|---|---|
| 1 | El archivo incrustado se ha registrado como adjunto a 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 interactiva en una página, utilice AddLinkToEmbeddedFile en su lugar. Para incrustar y registrar un archivo en una sola llamada, utilice EmbedFile
Véase también
AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount