PDFTool  7.0
Public Types | Public Member Functions | List of all members
PdfTk::PtlPages Class Reference

ページのコンテナを表現するクラスです。 More...

#include <PtlPages.h>

Public Types

enum  INSERT_OPTION {
  OPTION_NONE = 0x00000000, OPTION_EXECPT_ANNOTS = 0x00000001, OPTION_EXCEPT_FORMS = 0x00000002, OPTION_COPY_OUTLINES = 0x00000004,
  OPTION_COPY_ATTACHEDFILES = 0x00000008
}
 ページ挿入オプション More...
 
enum  NUM_PAGES { PAGE_ALL = -1 }
 挿入/削除するページ数。開始ページ以降全ページ対象。 More...
 
enum  INSERT_POS { INSERT_LAST = -1 }
 挿入する位置。 More...
 

Public Member Functions

int getHandle () const
 
 PtlPages ()
 コンストラクタ More...
 
 PtlPages (const PtlPages &obj)
 コピーコンストラクタ alias copy More...
 
 ‾PtlPages ()
 デストラクタ
 
PtlPagesoperator= (const PtlPages &obj)
 コピーオペレータ alias copy More...
 
bool isEmpty () const
 空かどうかを取得。 More...
 
int getCount () const
 ページ数を取得。 More...
 
PtlPage get (int index)
 ページを取得。 More...
 
void append (PtlPage &page, int param)
 ページを追加。 More...
 
void append (const PtlPDFDocument &doc, int fromNum, int numPages, int param)
 ページを追加。 More...
 
void append (const PtlParamImagePage &paramImagePage)
 画像ページを追加。 More...
 
void insert (int index, PtlPage &page, int param)
 ページを挿入。 More...
 
void insert (int index, const PtlPDFDocument &doc, int fromNum, int numPages, int param)
 ページを挿入。 More...
 
void insert (int index, const PtlParamImagePage &paramImagePage)
 画像ページを挿入。 More...
 
void move (int index, int fromNum, int numPages)
 ページを移動。 More...
 
void remove (int index)
 ページを削除。 More...
 
void remove (int index, int numPages)
 複数ページを削除。 More...
 
void removeAll ()
 全ページを削除。 More...
 

Detailed Description

ページのコンテナを表現するクラスです。

ページ番号は0オリジンとなっています。indexが0のものが先頭ページとなります。

Member Enumeration Documentation

◆ INSERT_OPTION

ページ挿入オプション

Enumerator
OPTION_NONE 

オプションはありません。

OPTION_EXECPT_ANNOTS 

注釈を除外してページ挿入します。

OPTION_EXCEPT_FORMS 

フォームを除外してページ挿入します。

OPTION_COPY_OUTLINES 

ページ挿入時にあわせてしおりをコピーします。 他PDFのページ挿入時に有効となります。

OPTION_COPY_ATTACHEDFILES 

ページ挿入時にあわせて添付ファイルをコピーします。 ここで言う添付ファイルは文書に添付されているものを指し、注釈に添付されているものは対象とはしません。 他PDFのページ挿入時に有効となります。

◆ INSERT_POS

挿入する位置。

Enumerator
INSERT_LAST 

最後に挿入

◆ NUM_PAGES

挿入/削除するページ数。開始ページ以降全ページ対象。

Enumerator
PAGE_ALL 

全ページ対象

Constructor & Destructor Documentation

◆ PtlPages() [1/2]

PdfTk::PtlPages::PtlPages ( )

コンストラクタ

Exceptions
PtlException

◆ PtlPages() [2/2]

PdfTk::PtlPages::PtlPages ( const PtlPages obj)

コピーコンストラクタ alias copy

Parameters
objコピー元オブジェクト。
Exceptions
PtlException

Member Function Documentation

◆ append() [1/3]

void PdfTk::PtlPages::append ( const PtlParamImagePage paramImagePage)

画像ページを追加。

最後に、画像ページを追加します。
画像がTiffの場合、PtlParamImagePageでsetImagePageNumberに-1を設定すると、
Tiffのページ数分ページが追加されます。

Parameters
paramImagePage画像ページ挿入パラメータ。
Exceptions
PtlException

◆ append() [2/3]

void PdfTk::PtlPages::append ( const PtlPDFDocument doc,
int  fromNum,
int  numPages,
int  param 
)

ページを追加。

最後に、ページを追加します。

Parameters
docPDF文書
fromNum開始ページ(ページ番号は0オリジン)
numPages追加するページ数
PAGE_ALLの指定も可能です。
paramページ挿入オプションを論理和で指定
Exceptions
PtlException

◆ append() [3/3]

void PdfTk::PtlPages::append ( PtlPage page,
int  param 
)

ページを追加。

最後に、ページを追加します。

Parameters
pageページ
paramページ挿入オプションを論理和で指定
Exceptions
PtlException

◆ get()

PtlPage PdfTk::PtlPages::get ( int  index)

ページを取得。

指定位置にあるページを取得します。

Parameters
index位置。0が先頭ページ。
indexが負やページ数以上の場合、例外が発生します。
Returns
ページ
Exceptions
PtlException

◆ getCount()

int PdfTk::PtlPages::getCount ( ) const

ページ数を取得。

Returns
ページ数
Exceptions
PtlException

◆ insert() [1/3]

void PdfTk::PtlPages::insert ( int  index,
const PtlParamImagePage paramImagePage 
)

画像ページを挿入。

指定位置に、画像ページを挿入します。
指定位置にあったページと後続のページは後ろに移動します。
画像がTiffの場合、PtlParamImagePageでsetImagePageNumberに-1を設定すると、
Tiffのページ数分ページが挿入されます。

Parameters
index位置。0が先頭。
indexが負やページ数以上の場合、例外が発生します。
paramImagePage画像ページ挿入パラメータ。
Exceptions
PtlException

◆ insert() [2/3]

void PdfTk::PtlPages::insert ( int  index,
const PtlPDFDocument doc,
int  fromNum,
int  numPages,
int  param 
)

ページを挿入。

指定位置に、指定されたページを挿入します。
指定位置にあったページと後続のページは後ろに移動します。

Parameters
index位置。0が先頭ページ。
indexが負やページ数以上の場合、例外が発生します。
docPDF文書
fromNum開始ページ(ページ番号は0オリジン)
numPages挿入するページ数
PAGE_ALLの指定も可能です。
paramページ挿入オプションを論理和で指定
Exceptions
PtlException

◆ insert() [3/3]

void PdfTk::PtlPages::insert ( int  index,
PtlPage page,
int  param 
)

ページを挿入。

指定位置に、指定されたページを挿入します。
指定位置にあったページと後続のページは後ろに移動します。

Parameters
index位置。0が先頭ページ。
indexが負やページ数以上の場合、例外が発生します。
pageページ
paramページ挿入オプションを論理和で指定
Exceptions
PtlException

◆ isEmpty()

bool PdfTk::PtlPages::isEmpty ( ) const

空かどうかを取得。

Returns
true: 空、false: 空ではない。
Exceptions
PtlException

◆ move()

void PdfTk::PtlPages::move ( int  index,
int  fromNum,
int  numPages 
)

ページを移動。

指定位置に、指定されたページを移動します。

Parameters
index位置。0が先頭ページ。
INSERT_LASTの指定も可能です。
fromNum開始ページ(ページ番号は0オリジン)
numPages移動するページ数
PAGE_ALLの指定も可能です。
Exceptions
PtlException

◆ operator=()

PtlPages& PdfTk::PtlPages::operator= ( const PtlPages obj)

コピーオペレータ alias copy

Parameters
objコピー元オブジェクト。

◆ remove() [1/2]

void PdfTk::PtlPages::remove ( int  index)

ページを削除。

指定位置のページを削除し、後続のページを前につめます。
削除して全ページがなくなった場合、そのまま保存すると例外が発生します。

Parameters
index位置。0が先頭ページ。
indexが負やページ数以上の場合、例外が発生します。
Exceptions
PtlException

◆ remove() [2/2]

void PdfTk::PtlPages::remove ( int  index,
int  numPages 
)

複数ページを削除。

指定位置のページから指定ページ数を削除し、後続のページを前につめます。
削除して全ページがなくなった場合、そのまま保存すると例外が発生します。

Parameters
index位置。0が先頭ページ。
indexが負やページ数以上の場合、例外が発生します。
numPages削除するページ数
PAGE_ALLの指定も可能です。
Exceptions
PtlException

◆ removeAll()

void PdfTk::PtlPages::removeAll ( )

全ページを削除。

全ページ削除してそのまま保存すると例外が発生します。
削除後はなんらかの形でページを追加してください。
全ページ削除しても文書情報などは元のままなので元の文書情報を引き継ぎたい場合などに利用できます。

Exceptions
PtlException