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 tree を AutoBumpedFeatures に記録します。呼び出し元がより低い保存バージョンに固定した場合、互換性ゲートは LastErrorCode 602 で保存を拒否します
構文
Delphi
Function DLAddFileAttachmentA(InstanceID: Integer; Title: PAnsiChar; EmbeddedFileID: Integer): Integer;
DLL
int DLAddFileAttachmentA(int InstanceID, const char * Title, int EmbeddedFileID);
パラメータ
| Title | ビューアーに表示され、/EmbeddedFiles 名前ツリーのキーとして使用される添付ファイル名です。空白にはできません |
|---|---|
| EmbeddedFileID | AddEmbeddedFile から返された値 |
戻り値
| 0 | EmbeddedFileID が無効、タイトルが空、またはアクティブなドキュメントがありません |
|---|---|
| 1 | 埋め込みファイルがドキュメントレベルの添付ファイルとして登録されました |
備考
この関数はドキュメントレベルの添付ファイルリストエントリを作成します。ページ上にクリック可能なアイコンまたはホットスポットを配置するには、代わりに AddLinkToEmbeddedFile を使用します。1 回の呼び出しでファイルを埋め込んで登録するには、EmbedFile を使用します
関連項目
AddEmbeddedFile、AddLinkToEmbeddedFile、EmbedFile、SetEmbeddedFileAFRelationship、EmbeddedFileCount