ページ群単位のページ数を設定する
書式:
HPDF_STATUS HPDF_SetPagesConfiguration(HPDF_Doc pdf,
HPDF_UINT page_per_pages);
戻り値
成功時 :HPDF_OK
失敗時 :エラーコードを返し、HPDF_Doc オブジェクトのハンドル生成時に渡したエラーハンドラをコールする。
エラー
- HPDF_INVALID_DOCUMENT
- 無効なドキュメントオブジェクトのハンドルが設定された
- HPDF_INVALID_DOCUMENT_STATE
- ドキュメントにはページオブジェクトが既に存在している
- HPDF_FAILD_TO_ALLOC_MEM
- メモリの確保に失敗した
引数
pdf :HPDF_Doc オブジェクトのハンドル
page_per_pages :pages オブジェクトが保持できるページ数
デフォルトでは、ドキュメントはひとつの pages オブジェクトを持っており、 これがすべてのページのルートとなります。各ページのオブジェクトは、 すべてこのオブジェクトの配下に作成されます。ひとつの pages オブジェクトが保持できるページ数は最大で 8191 までなので、 ドキュメントの最大ページ数は 8191 となります。しかし、パラメータ page_per_pages を指定することで、 これを変更することができます。ルートオブジェクトは 8191 を超える pages (ページではない) オブジェクトを保持することができ、 それぞれの pages が 8191 のページを保持するのです。 これにより、ドキュメントの最大ページ数は 8191*page_per_pages となります。