Objet PDFAttachment (interface IPDFAttachment)

Cet objet représente une pièce jointe PDF. Il donne accès au nom de fichier d’origine, à la description ajoutée par l’auteur ainsi qu’au type de liaison de la pièce jointe. Il expose également des méthodes permettant d’accéder au fichier joint en l’enregistrant sur le disque ou dans la mémoire globale.

​

Propriétés

Nom	Type	Description
Application	Engine, lecture seule	Renvoie l’objet Engine.
Binding	PDFAttachmentBindingEnum, lecture seule	Indique si le fichier joint est associé à une annotation, à PDF Portfolio ou au document dans son ensemble. Pour une pièce jointe ajoutée via l’API FineReader Engine, la valeur de cette propriété est toujours PAB_Document.
Description	BSTR, lecture seule	Renvoie la description attribuée au fichier lorsqu’il a été ajouté en pièce jointe.
FileFormat	ImageFileFormatEnum, lecture seule	Renvoie le format de fichier d’origine déterminé lors de son ouverture par ABBYY FineReader Engine. Si le format de la pièce jointe n’est pas égal à IFF_UnknownFormat, il peut être utilisé dans la méthode AddImageFileFromAttachment. Sinon, vous pouvez enregistrer la pièce jointe à l’aide de la méthode SaveToFile ou SaveToMemory (Win).
FileName	BSTR, lecture seule	Renvoie le nom de fichier d’origine.

​

Méthodes

Nom	Description
SaveToFile	Enregistre le fichier joint sur le disque.
SaveToMemory Remarque : Windows uniquement.	Enregistre le fichier joint dans la mémoire globale.

​

Objets liés

Diagramme d’objets

​

Paramètre d’entrée

Cet objet est passé en paramètre d’entrée à la méthode AddImageFileFromAttachment.

​

Paramètre de sortie

Cet objet correspond au paramètre de sortie des méthodes AddFromFile et AddFromMemory (Win) de l’objet PDFAttachments.

​

Exemples

Code C++ (COM)

FREngine::IEnginePtr Engine;
FREngine::IFRDocumentPtr sourceFile = Engine->CreateFRDocument();
sourceFile->AddImageFile( imageFilePath, 0, 0 );
// Récupérer la collection de pièces jointes du document source
FREngine::IPDFAttachmentsPtr attachments;
sourceFile->get_PDFAttachments( &attachments );
int attachmentsCount( 0 );
attachments->get_Count( &attachmentsCount );
// Ajouter les images des pièces jointes à un nouveau document à traiter
FREngine::IFRDocumentPtr frDocument = Engine->CreateFRDocument();
for( int j = 0; j < attachmentsCount; j++ ) {
    FREngine::IPDFAttachmentPtr attach;
    attachments->get_Element( j, &attach );
    FREngine::ImageFileFormatEnum fileFormat( FREngine::IFF_UnknownFormat );
    attach->get_FileFormat( &fileFormat );
    // Seuls les formats pris en charge par ImageFileFormatEnum peuvent être traités
    if( fileFormat != FREngine::IFF_UnknownFormat ) {
        frDocument->AddImageFileFromAttachment( attach, 0, 0, 0 );
    } else {
    // Toutes les pièces jointes peuvent être enregistrées
        BSTR fileName;
        attach->get_FileName( &fileName );
        attach->SaveToFile( fileName );
    }
}
 // Reconnaître le document
 frDocument->Process( 0 );     

​

Voir aussi

PDFAttachments

Factures électroniques conformes à la norme ZUGFeRD