PDFAttachment オブジェクト（IPDFAttachment インターフェイス）

ABBYY FineReader Engine API の PDFAttachment オブジェクト（IPDFAttachment インターフェイス）— 元のファイル名、説明、関連付けの種類を持つ PDF 添付ファイルを表し、添付ファイルをディスクまたはグローバルメモリに保存するメソッドを提供します。

このオブジェクトは、PDF の添付ファイルを表します。元のファイル名、作成者が追加した説明、および添付ファイルの関連付けの種類にアクセスできます。また、添付ファイルをディスクまたはグローバルメモリに保存して取得できるメソッドも提供します。

​

プロパティ

名前	型	説明
Application	Engine, 読み取り専用	Engine オブジェクトを返します。
Binding	PDFAttachmentBindingEnum, 読み取り専用	添付ファイルが 1 つの注釈、PDF Portfolio、またはドキュメント全体のいずれに関連付けられているかを指定します。FineReader Engine API を介して追加された添付ファイルの場合、このプロパティ値は常に PAB_Document です。
Description	BSTR, 読み取り専用	ファイルの添付時に付けられた説明を返します。
FileFormat	ImageFileFormatEnum, 読み取り専用	ABBYY FineReader Engine で開いた際に判定された元のファイル形式を返します。 添付ファイルの形式が IFF_UnknownFormat でない場合は、AddImageFileFromAttachment メソッドで使用できます。それ以外の場合は、SaveToFile または SaveToMemory (Win) メソッドを使用して添付ファイルを保存できます。
FileName	BSTR, 読み取り専用	元のファイル名を返します。

​

メソッド

名前	説明
SaveToFile	添付ファイルをディスク上に保存します。
SaveToMemory 注: Windows のみ。	添付ファイルをグローバルメモリ内に保存します。

​

関連オブジェクト

オブジェクト図

​

入力パラメーター

このオブジェクトは、AddImageFileFromAttachment メソッドの入力パラメーターとして渡されます。

​

出力パラメーター

このオブジェクトは、PDFAttachments オブジェクトの AddFromFile、AddFromMemory (Win) メソッドの出力パラメーターです。

​

サンプル

C++ (COM) コード

FREngine::IEnginePtr Engine;
FREngine::IFRDocumentPtr sourceFile = Engine->CreateFRDocument();
sourceFile->AddImageFile( imageFilePath, 0, 0 );
// ソースドキュメントから添付ファイルのコレクションを取得
FREngine::IPDFAttachmentsPtr attachments;
sourceFile->get_PDFAttachments( &attachments );
int attachmentsCount( 0 );
attachments->get_Count( &attachmentsCount );
// 処理用に、添付ファイル内の画像を新しいドキュメントに追加
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 );
    // サポートされている ImageFileFormatEnum のみ処理できます
    if( fileFormat != FREngine::IFF_UnknownFormat ) {
        frDocument->AddImageFileFromAttachment( attach, 0, 0, 0 );
    } else {
    // すべての添付ファイルを保存できます
        BSTR fileName;
        attach->get_FileName( &fileName );
        attach->SaveToFile( fileName );
    }
}
 // ドキュメントを認識
 frDocument->Process( 0 );     

​

関連項目

PDFAttachments

ZUGFeRD準拠の電子請求書