定義
function awPDF_DeletePagesW(
const | SessionID : Integer, |
const | FileName : PWideChar, |
const | SaveFileName : PWideChar, |
const | OverWrite : Boolean, |
const | PageRange : PWideChar, |
const | Password : PWideChar, |
const | RemoveSecurity : Boolean |
) : Integer;
機能
セッションオブジェクトを指定して変換サーバにPDFファイルの指定ページの削除を依頼します。
引数
SessionID | 関数 awPDF_ConnectServer で取得したセッションIDを設定します。 |
FileName | ページ削除を行う対象PDFファイル名をフルパスで設定します。(※1) |
SaveFileName | 変換後ファイル名をフルパスで設定します。(※1) |
OverWrite | 変換後ファイル名が既に存在する場合に上書きする場合はTrueを設定します。 |
PageRange | 削除するページ範囲を設定します。 |
Password | パスワードを設定します。(※1) |
RemoveSecurity | PDFファイルのセキュリティを解除する場合はTrueを設定します。 |
!!注意!! ※1
awPDFはUnicodeに対応していません。Unicode版の関数はデフォルト文字列型がUnicodeである開発環境での本ライブラリの使用を簡便にするために用意されたものですが、引数の文字列にANSI文字に変換できないUnicode特有の文字が含まれている場合正しく動作しません。
解説
対象PDFファイルの指定されたページを削除し、変換後ファイル名で指定されたパスへ保存します。
セッションオブジェクトはPDFファイルを受信するまで待機せずに次の操作を待ちます。関数 awPDF_CheckStatus を呼び出し、変換ステータスをチェックしてください。
セッションオブジェクトはPDFファイルを受信するまで変換サーバへの操作を受け付けません。(但し変換ステータスチェック、キャンセルは除く)
ページ範囲
1,3,6 のようにページ番号をカンマで区切って指定するか、4-8 のようにページ範囲を指定してください。
すべてのページを回転する場合はPageRangeを指定する必要はありません。
パスワード
PDFファイルを開くパスワードを設定します。ただし、開くパスワードとセキュリティ設定変更パスワードの両方が設定されているPDFファイルの場合、セキュリティ設定変更のパスワードを設定します。
ヒント
変換サーバで変換が完了するまでは関数 awPDF_ConvertCancel を呼び出しキャンセルすることができます。
!!注意!!
変換サーバで設定されている最大ファイルサイズを超えるファイルの変換はできません。ファイルサイズが最大ファイルサイズを超える場合関数 awPDF_DeletePages はエラーコード値を返します。変換サーバの最大ファイルサイズは、関数 awPDF_GetMaxFileSize で取得することができます。
戻り値
成功した場合は0 を、エラーが発生した場合はエラーコード値を返します。