しおりの情報を外部ファイルに保存する

保存しおり情報

しおりの情報を外部ファイルに保存する

しおりの情報をテキストデータにして出力できます。

テキストデータの形式は、CSV形式、XML形式、JSON形式の3種類です。いずれもエンコーディングはUTF-8です。CSV形式は、オプションで、項目名出力の有無とBOMのありなしを指定できます。出力したテキストデータファイルを「外部しおりファイル」と呼びます。

外部しおりファイルは次の手順で出力できます。

しおりメニュー

Mspng

CSVファイルの内容

図のようなしおりを作成して、CSVファイルを出力します。CSVファイル内の各フィールドのデータは表のようになります。(作成する条件により実際とは異なる場合があります。)

Mspng

しおりの表示される階層構造と順番は、データ内の「ID」と「親ID」、CSV のデータの並び順によって表現されています。CSVファイルをご利用の際は、実際にサンプルのしおりを作成して、内容を確認することをお勧めします。

しおり情報ファイルCSV形式

CSV形式の出力例

id,parent_id,text,destination-page-number,destination-type,destination-x1,destination-y1,destination-x2,destination-y2,destination-scaling,action-type,expand,external-destination,font-color,font-style,font-weight,font-size,relative-path,new-window
1,0,"しおり1",1,none,,,,,,goto,1,,#000000,normal,bold,0,0
2,0,"しおり2",2,xyz,0.00,19.84,,,0.00,goto,1,,#FF0000,normal,bold,0,0
3,2,"しおり3",2,xyz,0.00,81.34,,,-1.00,goto,1,,#000000,italic,normal,0,0
4,3,"しおり4",4,xyz,0.00,130.96,,,-1.00,gotor,1,Out.pdf,#000000,normal,normal,0,0
5,0,"しおり5",3,fith,,14.55,,,,goto,1,,#0000FF,normal,bold,0,0

フィールドの項目
 プロパティ項目名
しおり1しおり2しおり3しおり4しおり5
id
 --
12345
parent_id
 親ID
00230
text
 テキスト
しおり1しおり2しおり3しおり4しおり5
destination-page-number
 ページ番号
12243
destination-type
 表示方法
nonexyzxyzfitfith
destination-x1
 X座標(mm)
00
destination-y1
 Y座標(mm)
19.8481.3414.55
destination-x2
 右下X座標(mm)
destination-y2
 右下Y軸座標(mm)
destination-scaling
 表示倍率(%)
1000
action-type
 リンクアクション
gotogotogotogotorgoto
expand
 子しおりのリストを開く閉
11111
external-destination
 外部ファイル名
Out.pdf
font-color
 フォント色
#000000#FF0000#000000#000000#0000FF
font-style
 斜体
normalnormalitalicnormalnormal
font-weight
 太字
boldboldnormalnormalbold
relative-path
 相対パス
00000
new-window
 外部PDFファイルを新規ウインドウで開く
00000

CSVファイルの項目と設定値

CSVファイルの項目名しおりのプロパティ項目名
destination-page-numberページ番号飛び先ページ番号
ページ番号はPDFの先頭ページから数えたページ数、
「リンクアクション」の設定が「通常」と「外部のPDFを開く」の場合に有効
destination-type表示方法none = 動作なし
xyz = 固定
[表示倍率]が 0 = ズーム設定維持
fit  = 全体表示
fitv = 高さに合わせる
fith = 幅に合わせる
fitr = ビューに合わせる
destination-x1X座標表示開始位置(左上)のX座標(用紙左端からの距離) 単位:mm
destination-y1Y座標表示開始位置(左上)のY座標(用紙上端からの距離) 単位:mm
destination-x2右下X座標表示範囲右下のX座標 単位:mm
「表示法」が[ビューに合わせる]のとき有効
destination-y2右下Y軸座標表示範囲右下のY座標 単位:mm
「表示法」が[ビューに合わせる]のとき有効
destination-scaling表示倍率単位:% (0 = 倍率維持)
[表示方法]が「固定」のとき有効
action-typeリンクアクションUndefined = 未定義
GoTo = ファイル内移動
GoToR = ファイル間移動
Launch = ファイルを開く
URI = webページを開く
None = なし
expand子しおりのリストを開くしおりを表示したときのツリー開閉の有無
0 = 閉
1 = 開
external-destinationファイルパス又はURL[リンクアクション]が「通常」以外のときに有効
font-colorフォント色RGB値(16進数)
黒 = #000000、白 = #FFFFFF、赤 = #FF0000
font-style斜体normal = ノーマル
italic = 斜体
font-weight太字normal = ノーマル
bold = 太字
relative-pathリンクパス0 = 絶対パスで保存
1 = 相対パスで保存
new-window外部PDFファイルの開き方0 = 同じウインドウで開く
1 = 新規ウインドウで開く

XMLファイルの要素と設定値

しおり情報ファイルXML形式

要素名属性名しおりのプロパティ項目名
bookmark-tree  
 bookmark  
  textテキストテキスト内容
  destination-page-numberページ番号飛び先ページ番号
  destination-type表示方法none = 動作なし
xyz = 固定
fit  = 全体表示
fitv = 高さに合わせる
fith = 幅に合わせる
fitr = ビューに合わせる
  destination-x1X座標表示開始位置(左上)のX座標(用紙左端からの距離)
単位:mm
  destination-y1Y座標表示開始位置(左上)のY座標(用紙上端からの距離)
単位:mm
  destination-x2右下X座標表示範囲右下のX座標 単位:mm
「表示法」が[ビューに合わせる]のとき有効
  destination-y2右下Y座標表示範囲右下のY座標 単位:mm
「表示法」が[ビューに合わせる]のとき有効
  destination-scaling表示倍率単位:%
(0 = 倍率維持)
  expand子しおりのリストを開くしおりを表示したときのツリー開閉の有無
true = 開
false = 閉
  action-typeリンクアクションundef = 未定義
goto = ファイル内移動
gotor = ファイル間移動
lunch = ファイルを開く
uri = webページを開く
none = なし
  external-destinationファイルパスまたはURL※ブランク時未出力
  font-colorフォント色RGB値(16進数)
  font-style斜体normal = ノーマル
italic = 斜体
  font-weight太字normal = ノーマル
bold = 太字
  bookmark子に該当するデータがあれば出力される
  relative-pathリンクパスtrue = 相対パスで保存する
false = 絶対パスで保存する
  new-window外部PDFファイルの開き方true = 新規ウインドウで開く
false = 同じウインドウで開く
   ・・・  

JSONファイルの要素と設定値

しおり情報ファイルJSON形式

XML形式に準じます。