AddFileAttachmentA

文書プロパティ

説明

末尾の A は ANSI(char)DLL エントリポイントを示します。ActiveX/COM インターフェースでは Unicode 形式のみを公開します。動作は AddFileAttachment と同じで、文字列引数は現在の SetAnsiMode コードページを使用して解釈されます

既存の埋め込みファイルを PDF ビューアーの文書レベル添付ファイルとして登録します。添付ファイルパネルを表示できるリーダーは指定したタイトルを表示し、ユーザーが選択すると参照先の埋め込みファイルを開きます

最初に AddEmbeddedFile を呼び出してファイルバイト列を文書へコピーし、EmbeddedFileID を取得します。次に AddFileAttachment が、埋め込みバイト列を重複させずに、そのファイル仕様を Catalog の /Names /EmbeddedFiles 名前ツリーへ追加します

PDF バージョンの動作: AddEmbeddedFile は、PDF 1.3 が必要な埋め込みファイルストリームおよびファイル指定辞書を出力します。文書レベルの /Names /EmbeddedFiles 名前ツリーにファイルを登録するには PDF 1.4 が必要です。現在の文書バージョンがそれより低く、保存バージョンが固定されていない場合、AddFileAttachment は文書を自動的に PDF 1.4 へ引き上げ、/EmbeddedFiles name treeAutoBumpedFeatures に記録します。呼び出し元がより低い保存バージョンに固定した場合、互換性ゲートは LastErrorCode 602 で保存を拒否します

構文

Delphi

Function DLAddFileAttachmentA(InstanceID: Integer; Title: PAnsiChar; EmbeddedFileID: Integer): Integer;

DLL

int DLAddFileAttachmentA(int InstanceID, const char * Title, int EmbeddedFileID);

パラメータ

Titleビューアーに表示され、/EmbeddedFiles 名前ツリーのキーとして使用される添付ファイル名です。空白にはできません
EmbeddedFileIDAddEmbeddedFile から返された値

戻り値

0EmbeddedFileID が無効、タイトルが空、またはアクティブなドキュメントがありません
1埋め込みファイルがドキュメントレベルの添付ファイルとして登録されました

備考

この関数はドキュメントレベルの添付ファイルリストエントリを作成します。ページ上にクリック可能なアイコンまたはホットスポットを配置するには、代わりに AddLinkToEmbeddedFile を使用します。1 回の呼び出しでファイルを埋め込んで登録するには、EmbedFile を使用します

関連項目

AddEmbeddedFileAddLinkToEmbeddedFileEmbedFileSetEmbeddedFileAFRelationshipEmbeddedFileCount