12 PPS と PDFlib Block Plugin

カ ス タ ムプ ロパテ ィ の 取 得 カスタムプロパティは、 下 記 の 例 のよ うに 取 得 することが
で き ます。 こ こ では、 ページ pagenum 上 の b1 というブロックからプロパティ zipcode を
取 得 し ています :
zip = p.pcos_get_string(doc, "pages[" + pagenum + "]/blocks/b1/Custom/zipcode");
ブ ロ ッ ク 内 に 具 体 的 に 何 と い う カ ス タ ムプ ロパテ ィ があ る かわか ら なければ、 実 行 時 にそ
の 名 前 を 得 る こ と もでき ます。b1 と い う ブ ロ ッ ク の 最 初 のカ ス タ ムプ ロパテ ィ の 名 前 を 得
るには、 下 記 のよ うにします:
propname = p.pcos_get_string(doc, "pages[" + pagenum + "]/blocks/b1/Custom[0].key");
番 号 を 0 のかわ り に 1 つずつ 増 やし ていけば、すべてのカ ス タ ムプ ロパテ ィ の 名 前 を 得 る
ことができます。length 接 頭 辞 を 用 いれば、 カ ス タ ムプ ロパテ ィ の 数 を 知 る こ と がで き ま
す。
存 在 し ないブ ロ ッ ク プ ロパテ ィ と デフ ォル ト 値 ブ ロ ッ ク ま たはプ ロパテ ィ が 実 在 する
かど うかを 知 るには、 type 接 頭 辞 を 用 います。 パスに 対 する 型 が 0 か null ならば、 その
オブジ ェ ク ト は PDF 文 書 内 に 存 在 し ていません。 なお、 定 義 済 みプ ロパテ ィ の 場 合 、 こ
れはプロパテ ィ のデフ ォル ト 値 が 用 いられる こ と を 意 味 し ます。
カ ス タ ムプ ロパテ ィ の 名 前 空 間 さ ま ざ ま な 場 所 で 作 成 さ れた PDF 文 書 をや り 取 り する
際 に 混 乱 が 生 じ る こ と を 避 け る ため、 カ ス タ ムプ ロパテ ィ 名 をつけ る と き には 必 ず、 イ ン
ターネ ッ ト ド メ イ ン 名 を 企 業 固 有 の 接 頭 辞 と し て 用 い、 その 後 にコ ロ ン 「:」 と プ ロパテ ィ
名 本 体 を 続 け る こ と を 推 奨 し ます。 た と えば、 ACME 社 であれば 以 下 の よ う なプ ロパテ ィ
名 を 使 用 する のです :
acme.com:digits
acme.com:refnumber
標 準 プロパティ とカスタムプロパティはブロック 内 で 異 なる 格 納 のされ 方 をしているの
で、 標 準 PPS プ ロパテ ィ 名 (340 ページ 「12.6 ブ ロ ッ ク のプ ロパテ ィ 」 で 定 義 さ れてい る
も の) がカ ス タ ムプ ロパテ ィ 名 と 衝 突 する こ と は 決 し てあ り ません。
354 第 12 章 : PPS と PDFlib Block Plugin