CFDOCUMENT | |||
説明
CFML および HTML を含むテキストブロックから PDF または FlashPaper 形式の出力を作成します。 |
|||
カテゴリ
データ出力タグ | |||
シンタックス<cfdocument format = "PDF"、"FlashPaper" filename = "filename" overwrite = "yes"、"no" name = "output variable name" pagetype = "page type" pageheight = "page height in inches" pagewidth = "page width in inches" orientation = "portrait/landscape" margintop = "number" marginbottom = "number" marginleft = "number" marginright = "number" unit = "in"、"cm" encryption = "128-bit"、"40-bit"、"none" ownerpassword = "password" userpassword = "password" permissions = "permission list" fontembed = "yes"、"no" backgroundvisible = "yes"、"no" scale = "percentage less than 100"> HTML および CFML コード </cfdocument> |
|||
関連項目
cfreport、cfdocumentitem、cfdocumentsection |
|||
ヒストリ
ColdFusion MX 7: このタグが追加されました。
|
|||
使用方法
cfdocument タグを使用して、HTML および CFML の出力を PDF または FlashPaper 形式で表示します。ColdFusion MX は、HTML と CFML を <cfdocument> </cfdocument> ペアの外側には返しません。 cfdocument タグでは、次の標準をサポートする HTML を表示できます。
cfdocument タグは、Microsoft Word で生成された Internet Explorer 固有の HTML をサポートしません。 cfdocument タグで返された PDF または FlashPaper 形式のドキュメントにより、入力ストリーム内の既存の HTML は上書きされ、</cfdocument> タグの後の HTML は無視されます。 cfreport タグを cfdocument タグに埋め込むことはできません。 cfdocument タグを使用するときに、ColdFusion MX は cfdocument という名前の新しいスコープを作成します。このスコープには、次の変数が含まれています。
<cfif cfdocument.currentpagenumber gt 1> <cfoutput>#cfdocument.currentpagenumber-1#</cfoutput> </cfif> |
|||
例<cfdocument format="flashpaper"> <p>これは、cfdocument tag によって表示されるドキュメントです。</p> <table width="50%" border="2" cellspacing="2" cellpadding="2"> <tr> <td><strong>名前</strong></td> <td><strong>ロール</strong></td> </tr> <tr> <td>Bill</td> <td>リード</td> </tr> <tr> <td>Susan</td> <td>主任ライター</td> </tr> <tr> <td>Adelaide</td> <td>パートタイムのシニアライター</td> </tr> <tr> <td>Thomas</td> <td>6 か月フルタイム</td> </tr> <tr> <td>Michael</td> <td>4 か月フルタイム</td> </tr> </table> </cfdocument> |
FORMAT | |
必須 | |
レポートの形式を指定します。
|
FILENAME | |
オプション | |
PDF または FlashPaper 形式の出力を含むファイルの名前を指定します。 filename 属性を省略すると、ColdFusion MX は出力をブラウザに送ります。 |
OVERWRITE | |
オプション | |
Default value: "no"
ColdFusion MX で既存のファイルを上書きするかどうかを指定します。filename 属性と共に使用します。 |
NAME | |
オプション | |
タグが PDF 出力または FlashPaper 出力を保管する保管先の既存変数名を指定します。 |
PAGETYPE | |
オプション | |
Default value: "A4"
ColdFusion で生成するレポートのページサイズを指定します。
|
PAGEHEIGHT | |
オプション | |
ページの高さをインチ (デフォルト) またはセンチメートルを単位として指定します。この属性は、pagetype=custom の場合にのみ有効です。ページの高さをセンチメートル単位で指定するには、unit=cm 属性を使用します。 |
PAGEWIDTH | |
オプション | |
ページの幅をインチ (デフォルト) またはセンチメートルを単位として指定します。この属性は、pagetype=custom の場合にのみ有効です。ページの幅をセンチメートル単位で指定するには、unit=cm 属性を使用します。 |
ORIENTATION | |
オプション | |
Default value: "portrait"
ページの向きを指定します。
|
MARGINTOP | |
オプション | |
ページの上マージンをインチ (デフォルト) またはセンチメートルを単位として指定します。上マージンをセンチメートル単位で指定するには、unit=cm 属性を使用します。 |
MARGINBOTTOM | |
オプション | |
ページの下マージンをインチ (デフォルト) またはセンチメートルを単位として指定します。下マージンをセンチメートル単位で指定するには、unit=cm 属性を使用します。 |
MARGINLEFT | |
オプション | |
ページの左マージンをインチ (デフォルト) またはセンチメートルを単位として指定します。左マージンをセンチメートル単位で指定するには、unit=cm 属性を使用します。 |
MARGINRIGHT | |
オプション | |
ページの右マージンをインチ (デフォルト) またはセンチメートルを単位として指定します。右マージンをセンチメートル単位で指定するには、unit=cm 属性を使用します。 |
UNIT | |
オプション | |
Default value: "in"
pageheight、pagewidth、および margin の各属性で使用するデフォルトの単位を指定します。
|
ENCRYPTION | |
オプション | |
Default value: "none"
(format="PDF" の場合のみ) 出力を暗号化するかどうかを指定します。
|
OWNERPASSWORD | |
オプション | |
(format="PDF" の場合のみ) 所有者のパスワードを指定します。 |
USERPASSWORD | |
オプション | |
(format="PDF" の場合のみ) ユーザーのパスワードを指定します。 |
PERMISSIONS | |
オプション | |
(format="PDF" の場合のみ) 次のアクセス許可から 1 つ以上を指定します。
複数のアクセス許可を指定する場合は、カンマで区切ります。 |
FONTEMBED | |
オプション | |
Default value: "yes"
ColdFusion が出力にフォントを埋め込むかどうかを指定します。
Selective: Java フォントとコアフォント以外のすべてのフォントを埋め込みます。詳細については、「使用方法」を参照してください。 |
BACKGROUNDVISIBLE | |
オプション | |
Default value: "no"
ドキュメントの出力時に背景を出力するかどうかを指定します。
|
SCALE | |
オプション | |
Default value: "ColdFusion が計算する値"
スケール係数をパーセントで指定します。このオプションを使用して HTML 出力のサイズを縮小し、用紙のサイズに合うようにします。100 未満の数値を指定します。 |