VB.NET-TIPS などプログラミングについて

「 PHP PDF出力の方法について・マージンとヘッダ／フッタ（TCPDF）」 の記事ではいきなり Image メソッド使いましたが、今回はこのメソッドについてどの位使えるのかをテストしたいと思います。
Image メソッドの引数は以下の様になっています。

// Imageメソッド
public function Image($file, $x=null, $y=null, $w=0, $h=0, $type='', $link='', $align='', 
					   $resize=false, $dpi=300, $palign='', $ismask=false, $imgmask=false, 
					   $border=0, $fitbox=false, $hidden=false, $fitonpage=false, $alt=false, 
					   $altimgs=array())
// $file      : 画像ファイル名
// $x         : 領域左上のX座標[指定しない場合、現在のX座標位置]
// $y         : 領域左上のY座標[指定しない場合、現在のY座標位置]
// $w         : 領域の幅 [指定しない場合、自動計算される]
// $h         : 領域の高さ [指定しない場合、自動計算される]
// $type      : 画像フォーマット("JPEG", "PNG")
// $link      : AddLink()で作成したリンク識別子
// $align     : 次の画像を表示する位置
//             [T]: top-right for LTR or top-left for RTL
//             [M]: middle-right for LTR or middle-left for RTL
//             [B]: bottom-right for LTR or bottom-left for RTL
//             [N]: next line
// $resize    : [true]画像サイズを$wや$hに合わせてリサイズ
// $dpi       : 解像度(dot per inch)
// $palign    : 画像を現在の行のどこに配置するか
//             [L] : 左端
//             [C] : 中央
//             [R] : 右端
//             ['']: 左端(RTLの場合は右端)
// $ismask    : [true]画像をマスクする場合
// $imgmask   : 画像オブジェクトをメソッドの戻り値として取得する
//              (描画しない、w、h、x、yは無視される)場合true
// $border    : 境界線表示（0:枠無し,1:枠有 または "LRTB"の文字列で「左右上下」を指定）
// $fitbox    : [ture]($w, $h)で指定する領域に合わせて拡縮
// $hidden    : [ture]画像を画面に表示しない
// $fitonpage : [ture]ページの大きさに拡大する
// $alt       : If true the image will be added as alternative and not directly printed
//              (the ID of the image will be returned).
// $altimgs   : Array of alternate images IDs. Each alternative image must be an array with two values: 
//              an integer representing the image ID (the value returned by the Image method)
//              and a boolean value to indicate if the image is the default for printing. 

以下の各種のテストをしてみます。

• 画像の大きさ・リサイズ
• 次の画像位置指定・現在行の表示位置
• 幅・高さ($w, $h)指定領域に合わせて拡縮

■画像の大きさ・リサイズ

画像データは以下のものを使います。画像の大きさは「100×30」ピクセルです。

この画像を使って以下の表示をテストします。

• 画像の横幅・高さを指定しないでそのまま表示
• 画像の横幅・高さを指定して表示(20×6 mm)
• 画像の横幅・高さを指定して表示(100×30 mm)
• 画像の横幅・高さを指定して表示(100×30 mm) リサイズ指定有り

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();

// HTMLの定義
$strOut = '<h1>HTML Imageテスト</h1>';
$pdf->writeHTML($strOut, true, false, true, false, '');

$strOut = '画像の横幅・高さを指定しないでそのまま表示(100×30 px)';
$pdf->cell(0, 0, $strOut, 0, 1);

$pdf->Image('test-logo.png', null, null, 0, 0, 'PNG', '', 'N');

$unit = $pdf->pixelsToUnits(100);//px => mm
$strOut = '画像の横幅(100px ==> mm 換算)：'.$unit.'mm (pixelsToUnitsメソッド使用)';
$pdf->cell(0, 0, $strOut, 0, 1);
$pdf->cell(0, 0, '', 0, 1);

$strOut = '画像の横幅・高さを指定して表示(20×6 mm)';
$pdf->cell(0, 0, $strOut, 0, 1);
$pdf->Image('test-logo.png', null, null, 20, 6, 'PNG', '', 'N', false,300);
$pdf->cell(0, 0, '', 0, 1);

$strOut = '画像の横幅・高さを指定して表示(100×30 mm)';
$pdf->cell(0, 0, $strOut, 0, 1);
$pdf->Image('test-logo.png', null, null, 100, 30, 'PNG', '', 'N', false);
$strOut = '画像の横幅・高さを指定して表示(100×30 mm) (resize:true 指定)';
$pdf->cell(0, 0, $strOut, 0, 1);
$pdf->Image('test-logo.png', null, null, 100, 30, 'PNG', '', 'N', true, 300);

// pdf表示設定
$pdf->Output('pdf-img-5-1.pdf', 'I');
?>

これの実行結果は以下の通りです。

「画像の横幅・高さを指定しないでそのまま表示」の場合は実際PDF上でどのくらいの大きさで表示されるのかと言いますと、 画像データのピクセル値から DPI を加味して以下の計算で分かります。 （pixelsToUnits メソッドを使用すればピクセルからPDF上の長さが分かります。）

「画像のPDF上の横幅(mm)」＝「画像の横幅ピクセル値」／（「PDFでの指定DPI」／「25.4」）

この画像の場合は、以下の計算となります。
「画像のPDF上の横幅(mm)」＝「100px」／（「72」／「25.4」）＝「35.2777…」
（「DPI」のデフォルトは「72」になっています）

「画像の横幅・高さを指定して表示(20×6 mm)」では指定通り「20×6 mm」に縮小された表示になっています。
また、「画像の横幅・高さを指定して表示(100×30 mm)」では指定通り「100×30 mm」に拡大された表示になっています。
最後のリサイズ指定を「true」にした場合ですが、指定しない場合との違いが良くわかりませんでした。 指定の仕方が悪いのかそれともテストした画像データが適切ではなかったのか？機会があればもう少し調べたいと思います。

■次の画像位置指定・現在行の表示位置

「次の画像位置指定」は「$align」の引数ですが指示内容は以下の通りです。

• 'T' 画像TOPでかつ右端
• 'M' 画像縦方向の中央でかつ右端
• 'T' 画像BOTTOMでかつ右端
• 'N' 次の行

この指定は、画像表示が終わった時点でカレントのX,Y座標をどの位置にするかを示します。

「現在行の表示位置」は「$palign」の引数ですが指示内容は以下の通りです。

• 'L' 左揃え
• 'C' 中央揃え
• 'R' 右揃え
• '' 左揃え(RTLの場合は右端)

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();

// HTMLの定義
$strOut = '<h1>HTML Imageテスト</h1>';
$pdf->writeHTML($strOut, true, false, true, false, '');

// 元の画像そのまま
$pdf->writeHTML('<h4>元の画像(サイズ指定無し)</h4>', true, false, true, false, '');
$pdf->Image('test-logo.png', null, null, 0, 0, 'PNG');

// $align : 次の画像を表示する位置
$pdf->SetXY(0, 35);
$pdf->writeHTML('<h4>次の画像の表示位置「$align」</h4>', true, false, true, false, '');
$pdf->Image('test-logo.png', null,   40, 0, 0, 'PNG', '', 'T'); //top-right
$pdf->Image('test-logo.png', null, null, 0, 0, 'PNG', '', 'M'); //middle-right
$pdf->Image('test-logo.png', null, null, 0, 0, 'PNG', '', 'B'); //bottom-right
$pdf->Image('test-logo.png', null, null, 0, 0, 'PNG', '', 'N'); //next line
$pdf->Image('test-logo.png', null, null, 0, 0, 'PNG', '', 'N'); //next line

// $palign    : 画像を現在の行のどこに配置するか
$pdf->SetXY(0, 80);
$pdf->writeHTML('<h4>現在行の配置指定「$palign」</h4>', true, false, true, false, '');
$pdf->writeHTML('<h4>・幅[50mm]指定・左寄せ</h4>', true, false, true, false, '');
$pdf->Image('test-logo.png', null, null, 40, 0, 'PNG', '', 'N', false, 300, 'L');
$pdf->writeHTML('<h4>・幅[50mm]指定・中央揃え</h4>', true, false, true, false, '');
$pdf->Image('test-logo.png', null, null, 40, 0, 'PNG', '', 'N', false, 300, 'C');
$pdf->writeHTML('<h4>・幅[50mm]指定・右寄せ</h4>', true, false, true, false, '');
$pdf->Image('test-logo.png', null, null, 40, 0, 'PNG', '', 'N', false, 300, 'R');

// pdf表示設定
$pdf->Output('pdf-img-5-2.pdf', 'I');
?>
?>

実行結果は以下の様な表示になります。

■幅・高さ($w, $h)指定領域に合わせて拡縮

幅・高さ($w, $h)指定領域に合わせて拡縮を行う引数である「$fitbox」についてテストを行います。

「$fitbox」は2文字で指定し、1文字目は水平方向の配置指定で、2文字目は垂直方向の配置指定となります。

「1文字目は水平方向」

• 'L' 左寄せ
• 'C' 中央揃え
• 'R' 右寄せ

「2文字目は垂直方向」

• 'T' 上寄せ
• 'M' 中央揃え
• 'B' 下寄せ

3種類ずつなので9種類の組み合わせがります。 但し、画像のサイズと描画領域（$w, $h）の値により表示がいろいろあります。

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();

// HTMLの定義
$strOut = '<h1>HTML Imageテスト</h1>';
$pdf->writeHTML($strOut, true, false, true, false, '');

$pdf->Image('test-logo.png', null, null, 0, 0, 'PNG', '', 'N');
$unit = $pdf->pixelsToUnits(100);//px => mm
$strOut = '画像の横幅(100px ==> mm 換算)：'.$unit.'mm (pixelsToUnitsメソッド使用)';
$pdf->MultiCell( 0, 0, $strOut, 0, '', false, 1, 50, 18);
$unit = $pdf->pixelsToUnits(30);//px => mm
$strOut = '画像の高さ( 30px ==> mm 換算)：'.$unit.'mm (pixelsToUnitsメソッド使用)';
$pdf->MultiCell( 0, 0, $strOut, 0, '', false, 1, 50, 23);

// 引数「fitbox」用alignment
$h_align = array('L', 'C', 'R');
$v_align = array('T', 'M', 'B');

$x = 15;
$y = 32;
$w = 30;
$h = 7;
// 横方向のアライメント
for ($i = 0; $i < 3; ++$i) {
	$x = 15;
	for ($j = 0; $j < 3; ++$j) {
		$fitbox = $h_align[$i].$v_align[$j];
		$pdf->Rect($x, $y, $w, $h, 'F', array(), array(128,255,128));
		$pdf->Image('test-logo.png', $x, $y, $w, $h, 'PNG', '', '', false, 300, '', false, false, 0,
                       $fitbox, false, false);
        $pdf->MultiCell( 0, 0, '$fitbox = '.$fitbox, 0, '', false, 1, $x, $y + $h);
		$x += 62; // カラムを右へ
	}
	$y += 14; // 次の行
}


$x = 15;
$y += 2;
$w = 30;
$h = 15;
// 縦方向のアライメント
for ($i = 0; $i < 3; ++$i) {
	$x = 15;
	for ($j = 0; $j < 3; ++$j) {
		$fitbox = $h_align[$i].$v_align[$j];
		$pdf->Rect($x, $y, $w, $h, 'F', array(), array(255,128,128));
		$pdf->Image('test-logo.png', $x, $y, $w, $h, 'PNG', '', '', false, 300, '', false, false, 0,
                       $fitbox, false, false);
        $pdf->MultiCell( 0, 0, '$fitbox = '.$fitbox, 0, '', false, 1, $x, $y + $h);
		$x += 62; // カラムを右へ
	}
	$y += ($h + 6); // 次の行
}

// pdf表示設定
$pdf->Output('pdf-img-5-3.pdf', 'I');
?>

実行結果は以下の様な表示になります。

この表示領域の配置指定は、画像のサイズと描画領域（$w, $h）の値により表示のされ方が独特です。

最初の9個のブロック（背景が黄緑色）は1文字目の指定の水平方向しか動作していない様に見えます。
また、その下の9個のブロック（背景が薄赤色）は2文字目の指定の垂直方向しか動作していない様に見えます。

最初のブロックの場合、「$w = 30」「$h = 7」（単位はmm）で指定しています。
画像の大きさは「100×30px」ですので横を基準とした場合の「縦」を計算します。
「縦」＝「30($w)」×（「30px」／「100px」）＝「9」mm
「縦＝9mm」では指定の「$h = 7」を超えてしまうので、逆に「$h = 7」を基準にして「横」を計算します。
「横」＝「7($h)」×（「100px」／「30px」）＝「23.3…」mm
「横＝23.3…mm」で指定の「$w = 30」におさまります。 よって、垂直方向は一杯になり水平方向しか配置が動作しない様に見えるわけです。


2番目のブロックの場合、「$w = 30」「$h = 15」（単位はmm）で指定しています。
画像の大きさは「100×30px」ですので横を基準とした場合の「縦」を計算します。
「縦」＝「30($w)」×（「30px」／「100px」）＝「9」mm
さらにに「$h = 15」を基準にして「横」を計算します。
「横」＝「15($h)」×（「100px」／「30px」）＝「50」mm
「横＝50mm」のため「$w = 30」の指定を超えてしまいます。 よって、「縦＝9mm」の画像として、水平方向は一杯になり垂直方向しか配置が動作しない様に見えるわけです。

一連のPDF出力の初回の 「PHP PDF出力の方法について（TCPDF）」 の記事ではいきなり writeHTML メソッド使いましたが、今回はこのメソッドについてどの位使えるのかをテストしたいと思います。
writeHTML メソッドの引数は以下の様になっていますので、大まかに各引数について説明します。

// writeHTMLメソッド
public function writeHTML($html, $ln=true, $fill=false, $reseth=false, $cell=false, $align='')
// $html   : 出力するHTMLテキスト
// $ln     : 改行指定[true:改行]（デフォルト:true）
// $fill   : 背景の塗つぶし指定 [false:透明(既定) true:塗つぶす]（デフォルト:false）
// $reseth : [true]前回の高さ設定をリセットする。[false]引き継ぐ
// $cell   : [true]setCellPadding()で設定されたセルのpaddingを挿入する
// $align  : テキストの整列を指定
//           [L] or 空文字: 左揃え(既定)
//           [C]: 中央揃え
//           [R]: 右揃え
//           [J]: 両端揃え

各種の HTML タグをテストしてみます。

• リストタグ
• TABLEタグテスト
• TABLEタグテスト・その２（注意点）
• 前景色、背景色の色名テスト

■リストタグ

HTML では ul、ol、li の3つのタグを使ってリストを作ることができますが、 「ul、li」または「ol、li」のセットで指定をします。 各リストの項目に以下の様な修飾タグをテストしてみます。

• 画像表示タグ：<img>
• 文字の太字（ボールド）：<b>
• 文字のイタリック：<i>
• 文字の下線（アンダーライン）：<u>
• アンカータグ：<a>
• 文字の取消線：<del>
• フォントサイズ：<font>
• 下付き文字要素：<sub>
• 上付き文字要素：<sup>

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();
// HTMLの定義
$html = <<< EOF
<h1>HTML リストタグテスト（<ol>　<li>）（<ul>　<li>）</h1>
<h4>リスト例:（<ol>　<li>）</h4>
<ol>
	<li><img src="test-logo.png" alt="" width="100" height="" border="0" />イメージ　テスト</li>
	<li><b>ボールド　テスト</b></li>
	<li><i>イタリック　テスト</i></li>
	<li><u>下線　テスト</u></li>
	<li><b>ボールド  <i>ボールド・イタリック  <u>ボールド・イタリック・下線</u></i></b></li>
	<li><a href="https://www.yahoo.co.jp/" dir="ltr">https://www.yahoo.co.jp/へのリンク</a></li>
	<li>これは改行の<br />が文字列の中に入るテストです。<br />
	    ここは２行目です。<br />
	    ここは３行目です。
    </li>
	<li>サブリスト
		<ol>
			<li>サブリスト１行目
				<ul>
					<li>さらにサブリスト１行目</li>
					<li>さらにサブリスト２行目</li>
				</ul>
			</li>
			<li>サブリスト１行目</li>
		</ol>
	</li>
	<li><del>取り消し線　テスト</del></li>
	<li><font size="+3">フォントサイズ　テスト:"+ 3"</font></li>
	<li><small>フォント:small</small> フォント:通常 <sub>下付き文字要素</sub>  通常に戻す
 <sup>上付き文字要素</sup> 通常に戻す</li>
</ol>
<h4>リスト例:（<ul>　<li>）</h4>
<ul>
	<li><b>ボールド　テスト</b></li>
	<li><i>イタリック　テスト</i></li>
	<li><u>下線　テスト</u></li>
</ul>
EOF;

// HTML書式で出力する
$pdf->writeHTML($html);

// pdf表示設定
$pdf->Output('pdfwrtHTML-1.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

これの実行結果は以下の通りです。

■TABLEタグテスト

TABLEタグの以下の様なテスト行ってみます。

• TABLEの border, cellspacing, cellpadding 属性
• <th> の align 属性
• <td> の align, bgcolor, colspan 属性
• <td> のセル内の文字列属性（イタリック、aタグ、下付き文字、上付き文字など）
• <td> のセル内の TABLE 記述
• <td> の color, bgcolor, colspan, rowspan 属性

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();
// HTMLの定義
$html = '<h2>HTML TABLEテスト</h2>
<table border="1" cellspacing="6" cellpadding="4">
    <tr>
        <td>a</td>
        <td>b</td>
    </tr>
    <tr>
        <td>c</td>
        <td>d</td>
    </tr>
</table>';

$html = '<h2>HTML TABLEテスト</h2>
<table border="1" cellspacing="3" cellpadding="4">
	<tr>
		<th>タイトル</th>
		<th align="right">右寄せタイトル</th>
		<th align="left">左寄せタイトル</th>
		<th align="center">中央揃えタイトル</th>
	</tr>
	<tr>
		<td>通常のtd</td>
		<td bgcolor="#cccccc" align="center" colspan="2">
		    <i>イタリックテスト</i>
		    aタグテスト<a href="https://www.yahoo.co.jp/">yahoo</a> 最後に改行<br />
    	    <small>フォント:small</small> フォント:通常 <sub>下付き文字要素</sub>
    	     通常に戻す <sup>上付き文字要素</sup> 通常に戻す
		    <ol>
		      <li>リスト１番目
		        <ol>
		          <li>サブリスト１番目</li>
		          <li>サブリスト２番目</li>
		        </ol>
		      </li>
		      <li>リスト２番目</li>
		    </ol>
		    <small color="#FF0000" bgcolor="#FFFF00">小文字指定「small」の文字列テスト</small>
		</td>
		<td align="center">中央揃え　td:4B</td>
	</tr>
	<tr>
		<td>
		    セルの中のTABLE<br />
            <table border="1" cellspacing="3" cellpadding="4">
                <tr>
                    <td>a</td>
                    <td>b</td>
                </tr>
                <tr>
                    <td>c</td>
                    <td>d</td>
                </tr>
            </table>
		</td>
		<td bgcolor="#0000FF" color="yellow" align="center">[背景色:青色][中央揃え]</td>
		<td bgcolor="#FFFF00" align="left">[中央揃え]<font color="#FF0000">[赤]</font>[背景色:黄色]</td>
		<td>4C</td>
	</tr>
	<tr>
		<td>セル：1A</td>
		<td rowspan="2" colspan="2" bgcolor="#FFFFCC">セル：2AA<br />セル：2AB<br />セル：2AC</td>
		<td bgcolor="#FF0000">セル：4D</td>
	</tr>
	<tr>
		<td>セル：1B</td>
		<td>セル：4E</td>
	</tr>
	<tr>
		<td>セル：1C</td>
		<td align="right" >右寄せセル：2C</td>
		<td align="left"  >左寄せセル：3C</td>
		<td align="center">中央揃えセル：4F</td>
	</tr>
</table>';

// HTML書式で出力する
$pdf->writeHTML($html);

// pdf表示設定
$pdf->Output('pdfwrtHTML-2.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

実行結果は以下の様な表示になります。 TABLEタグの描画は普通の使い方であれば、結構できそうな感じです。

■TABLEタグテスト・その２（注意点）

引き続きTABLEタグテストを行いますが、注意点を示そうと思い以下のソースをテストしてみます。

setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();
// HTMLの定義
$html = '<h2>HTML TABLEの中の画像データテスト</h2>
<table cellpadding="1" cellspacing="1" border="1" style="text-align:center;">
    <tr>
        <td height="50"><img src="test-logo.png" border="0" width="100" /></td>
    </tr>
    <tr style="text-align:left;   vertical-align:top;">
        <td height="50"><img src="test-logo.png" border="0" width="100" /></td>
	</tr>
    <tr style="text-align:center; vertical-align:middle;">
        <td height="50"><img src="test-logo.png" border="0" width="100" /></td>
	</tr>
    <tr style="text-align:right;  vertical-align:bottom;">
        <td height="50"><img src="test-logo.png" border="0" width="100" /></td>
	</tr>
</table>';

// HTML書式で出力する
$pdf->writeHTML($html);

// pdf表示設定
$pdf->Output('pdfwrtHTML-3.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

実行結果は以下の様な表示になります。

画像の縦の配置を tr タグのスタイルで style="vertical-align:middle;" などと指定したのですが、常にTOP位置での表示になります。
HTML ソースでこれを以下の様に記述して、ブラウザで表示させると、正しい表示になります。

<html>
<head>
<meta charset="utf-8">
<title>HTML TABLE</title>
</head>
<body>
<h2>HTML TABLEの中の画像データテスト</h2>
<table cellpadding="1" cellspacing="1" border="1" style="text-align:center;" width="800">
    <tr>
        <td height="50"><img src="test-logo.png" border="0" width="100" /></td>
    </tr>
    <tr style="text-align:left;   vertical-align:top;">
        <td height="50"><img src="test-logo.png" border="0" width="100" /></td>
	</tr>
    <tr style="text-align:center; vertical-align:middle;">
        <td height="50"><img src="test-logo.png" border="0" width="100" /></td>
	</tr>
    <tr style="text-align:right;  vertical-align:bottom;">
        <td height="50"><img src="test-logo.png" border="0" width="100" /></td>
	</tr>
</table>
</body>
</html>

実行結果は以下の様な表示になります。

writeHTML メソッドでは、どうも css (スタイル)の指定で style="vertical-align:xxxxx;" は効かない様です。

ネットで調べると以下の css (スタイル)しか指定できない様です。
font-family, font-size, font-weight, font-style, color, background-color, text-decoration, width, height, text-align

vertical-align が使えないとなると改行などで位置合わせをする必要がありそうです。

■前景色、背景色の色名テスト

TCPDF ではPHPのプログラムでWEB上のカラー名を宣言してありますので、それを利用できます。
TCPDF_COLORS クラスのstatic宣言されている $webcolor がそれで、キーにカラー名、値にRGBの16進表記の数値文字列が定義されています。
以下に使用例を示します。

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();

// HTMLの定義
$strOut = '<h1>HTML カラー名テスト</h1>';
$strOut .= '<h2>前景色</h2>';

$strColor = 'red';
$strColorHex = TCPDF_COLORS::$webcolor[$strColor];
$strOut .= '<span color="#'.$strColorHex.'">'.$strColor.'-test</span><br />';

$strColor = 'green';
$strColorHex = TCPDF_COLORS::$webcolor[$strColor];
$strOut .= '<span color="#'.$strColorHex.'">'.$strColor.'-test</span><br />';

$strColor = 'blue';
$strColorHex = TCPDF_COLORS::$webcolor[$strColor];
$strOut .= '<span color="#'.$strColorHex.'">'.$strColor.'-test</span><br />';

$pdf->writeHTML($strOut, true, false, true, false, '');

$strOut = '<h2>背景色</h2>';

$strColor = 'red';
$strColorHex = TCPDF_COLORS::$webcolor[$strColor];
$strOut .= '<span bgcolor="#'.$strColorHex.'" color="white">'.$strColor.'-test</span><br />';

$strColor = 'green';
$strColorHex = TCPDF_COLORS::$webcolor[$strColor];
$strOut .= '<span bgcolor="#'.$strColorHex.'" color="white">'.$strColor.'-test</span><br />';

$strColor = 'blue';
$strColorHex = TCPDF_COLORS::$webcolor[$strColor];
$strOut .= '<span bgcolor="#'.$strColorHex.'" color="white">'.$strColor.'-test</span><br />';

$pdf->writeHTML($strOut, true, false, true, false, '');

// pdf表示設定
$pdf->Output('pdfwrtHTML-4-1.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

実行結果は以下の様な表示になるはずです。

ちなみに宣言されているカラー名を全て表示すると以下の様になります。

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();

// HTMLの定義
$strOut = '<h1>HTML カラー名テスト</h1>';

$strOut .= '<h2>前景色</h2>';
foreach(TCPDF_COLORS::$webcolor as $k => $v) {
	$strOut .= '<span color="'.$k.'">'.$v.'</span> ';
}

$strOut .= '<h2>背景色</h2>';
foreach(TCPDF_COLORS::$webcolor as $k => $v) {
	$strOut .= '<span bgcolor="'.$k.'" color="#404040">'.$v.'</span> ';
}

$pdf->writeHTML($strOut, true, false, true, false, '');

// pdf表示設定
$pdf->Output('pdfwrtHTML-4-2.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

実行結果は以下の様な表示になるはずです。

今回は TCPDF に備わっている　トランザクション処理 について説明したいと思います。

トランザクション処理と言えばデータベースでの更新処理には付きものの処理で PHP でプログラムした方であれば使用したことがあると思います。

TCPDF に備わっているトランザクション処理も、データベース処理でのものとよく似ています。
トランザクションを開始し処理がOKであればコミットを行い、何か問題があればロールバックすることになります。

TCPDF のトランザクション処理メソッドは以下の通りです。

• startTransaction() : トランザクション開始
• commitTransaction() : トランザクションコミット
• rollbackTransaction() : トランザクションロールバック

それでは簡単な例として以下のソースを見て下さい。

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();
// valign テスト
$pdf->Write(0, "transaction テスト\n");

// transaction開始
$pdf->startTransaction();
// 2行書込み
$pdf->Write(0, "transaction - 1\n");
$pdf->Write(0, "transaction - 2\n");

// transactionリスタート
$pdf->startTransaction();
// 1行書込み
$pdf->Write(0, "transaction - 3\n");
// 最後のtransactionに戻る
$pdf = $pdf->rollbackTransaction();	// 戻り値を元の「$pdf」にコピーに注意!!

// transaction無し・2行書込み
$pdf->Write(0, "transaction - 4\n");
$pdf->Write(0, "transaction - 5\n");

// transaction開始
$pdf->startTransaction();
// 1行書込み
$pdf->Write(0, "transaction - 6\n");
// transactionコミット
$pdf->commitTransaction();

// pdf表示設定
$pdf->Output('pdftrans-1.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

これの実行結果は以下の通りです。

この例で注意する点が startTransaction メソッドでトランザクションを開始し、PDF出力処理を行った後に再度トランザクションを開始しています。

そうしますと結果として再度のトランザクションはそれまでのトランザクションをコミットし、再度トランザクションを開始する様です。 その後 Write メソッドで「transaction - 3」の文字列の出力を行いますが、rollbackTransaction メソッドでロールバックを行うと、 「transaction - 3」の文字列が表示されなくなります。

rollbackTransaction メソッドの戻り値は TCPDF オブジェクトを返すのですが、 そのオブジェクトはトランザクションで貯めていたPDF出力操作がクリアな状態になります。

TCPDF のトランザクション処理はそこまで難しくは無いのですが、私としてはどの様な時に使うのかがいまいちよく分かりません。

■トランザクション処理のページ跨ぎのテスト

上記の例でトランザクション処理のロールバックにより、 startTransaction メソッドから rollbackTransaction メソッドに はさまれたPDF出力の処理が行われないことを説明しました。

ところで以前 MultiCell メソッドにおいて縦方向が伸長される場合があることを記しました。 その時、次のページへの伸長もあることを説明しましたが、これにトランザクション処理を入れた場合 ページの処理はどうなるかが気になりましたので、以下のソースでテストしてみました。

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();

// valign テスト
$pdf->Write(0, 'valign テスト', '', false, '', true);
$strAdd = "\r\n0123456789\r\n0123456789";
$strTxt = "\$valign['T']:Top   \r\n\$align['L']左揃え"  .$strAdd;

// 以下の「MultiCell」の一連の処理をトランザクションで挟む
// transaction開始
$pdf->startTransaction();

// 線のStyleで「破線」指示
$pdf->SetLineStyle(array('dash' => '2'));
// 縦サイズ：20で文字列を表示
$h = 10;
$y = 265;
$pdf->MultiCell(60, $h, $strTxt, 1, 'L', false, 1,  10, $y, true, 0, false, true, 60,'T');

// ロールバック
$pdf = $pdf->rollbackTransaction();
//$pdf->commitTransaction();

// 線のStyleで「破線」指示で、色がRGB指定で「赤」
$pdf->setPage(1);
$pdf->SetLineStyle(array('dash' => '2', 'color' => array(255, 0, 0)));
// 四角い枠線を表示（縦サイズ：20）
$pdf->Rect( 10, $y, 60, $h, 'D');

// pdf表示設定
$pdf->Output('pdftrans-2.pdf', 'I');
?>

これの実行結果は以下の通りです。

MultiCell メソッドの描画が割愛された表示になっているのが分かります。

ロールバックとコミットのコメントを入れ替えると、 ページが伸長され２ページ渡って MultiCell メソッドの描画が行われるはずです。

前回の 「PHP PDF出力の方法について・矩形領域への文字列出力（MultiCellメソッド）」 の記事では MultiCell メソッドを説明しましたが、今回は MultiCell メソッドの注意点について説明します。

それでは以下のソースを見て下さい。
前回の説明の時の「valign テスト」のソースを少し変更しています。

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();
// valign テスト
$pdf->Write(0, 'valign テスト', '', false, '', true);
$strAdd = "\r\n0123456789\r\n0123456789";
$strTxt = "\$valign['T']:Top   \r\n\$align['L']左揃え"  .$strAdd;
// 線のStyleで「破線」指示
$pdf->SetLineStyle(array('dash' => '2'));
// 縦サイズ：20で文字列を表示
$pdf->MultiCell(60, 10, $strTxt, 1, 'L', false, 1,  10, 20, true, 0, false, true, 60,'T');

// 線のStyleで「破線」指示で、色がRGB指定で「赤」
$pdf->SetLineStyle(array('dash' => '2', 'color' => array(255, 0, 0)));
// 四角い枠線を表示（縦サイズ：20）
$pdf->Rect( 10, 20, 60, 10,'D');

// pdf表示設定
$pdf->Output('pdf5-1.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

これの実行結果は以下の通りです。

この例で MultiCell メソッドで 「valign」が「'T':Top」で「align」を「'L':Left」の指定で表示しますが、縦方向のサイズを「10」にしています。 表示文字列は改行が3回入るため、そのサイズでは溢れるはずです。
なお MultiCell メソッドの枠線を破線で表示するため SetLineStyle メソッドを使用しています。

MultiCell メソッドでは「横:60、縦:10」で範囲を指定していますので、 その大きさを赤い枠線で表示するため Rect メソッドを使用しています。

出力結果から分かる様にMultiCell メソッドでは縦サイズに収まらない場合、縦方向の伸長がされます。
そのため表示する文字列の文字数のMAX値や改行などを考慮して伸長されても問題無い様に考える必要があります。

ここで唐突に SetLineStyle メソッド Rect メソッドがでてきましたので、メソッドの引数について説明します。

// SetLineStyleメソッド
public function setLineStyle($style, $ret=false)
// $style  : 線スタイル連想配列（以下の文字列をキーとする配列）
//           'width':線の幅（float値）
//           'cap'  :線のCAP （文字列:'butt','round','square'）
//           'join' :線のJOIN（文字列:'miter','round','bevel'）
//           'dash' :破線パターン（文字列で破線のON/OFFを指定）
//                    例1:"2"のみの場合、「ON:2」「OFF:2」
//                    例1:"3,1の場合、   「ON:3」「OFF:1」
//           'phase':破線パターンの開始位置のシフトする長さ（integer値）
//           'color':破線の色指定（array値）
//                    書式1: array(GREY)
//                    書式2: array(R,G,B)
//                    書式3: array(C,M,Y,K)
//                    書式4: array(C,M,Y,K,SpotColorName)
// 
// $ret    : [true]:コマンドを送信しない

// Rectメソッド
public function Rect($x, $y, $w, $h, $style='', $border_style=array(), $fill_color=array())
// $x      : 矩形領域左上のX座標（float）
// $y      : 矩形領域左上のY座標（float）
// $w      : 幅  （float）
// $h      : 高さ（float）
// $style  : 描画スタイル（文字列）
//           'D' or ''(空文字): 線画
//           'F': 塗りつぶし
//           'DF' or 'FD': 線画＋塗りつぶし
//           'CNZ': クリッピングモード(even-odd方式).
//           'CEO': クリッピングモード(non-zero方式).
// $border_style : 境界線描画スタイル（array）「SetLineStyle()」に似ている
// $fill_color   : 塗りつぶし色（array）
//                 ・書式1: array(GREY)
//                 ・書式2: array(R,G,B)
//                 ・書式3: array(C,M,Y,K)
//                 ・書式4: array(C,M,Y,K,SpotColorName)

■MultiCell のさらなる注意点

上記の例で MultiCell メソッドでは縦方向に指定した矩形領域を超える場合、領域の縦方向への伸長が行われることを示しました。

さらに MultiCell メソッドの描画開始Y座標をページの下の方に指定し、描画が1ページ内に収まらない場合どうなるのかを見てみます。 ソースは以下の様になります。

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();
// valign テスト
$pdf->Write(0, 'valign テスト', '', false, '', true);
$strAdd = "\r\n0123456789\r\n0123456789";
$strTxt = "\$valign['T']:Top   \r\n\$align['L']左揃え"  .$strAdd;
// 線のStyleで「破線」指示
$pdf->SetLineStyle(array('dash' => '2'));
// 縦サイズ：20で文字列を表示
$h = 10;
// Y座標
$y = 265;
$pdf->MultiCell(60, $h, $strTxt, 1, 'L', false, 1,  10, $y, true, 0, false, true, 60,'T');

// 線のStyleで「破線」指示で、色がRGB指定で「赤」
$pdf->setPage(1);
$pdf->SetLineStyle(array('dash' => '2', 'color' => array(255, 0, 0)));
// 四角い枠線を表示（縦サイズ：20）
$pdf->Rect( 10, $y, 60, $h, 'D');

// pdf表示設定
$pdf->Output('pdf5-2.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

これの実行結果は以下の通りです。

MultiCell メソッドの描画が1ページ収まらない場合、次のページに境界線を含めて拡張されるのが分かります。 この件も、十分に注意が必要だと思います。

仕様的にどうしても1ページにおさめなければならに場合は、データに制限を掛けるかですが。
他にも方法はある様ですが、例えば描画トランザクションでページが拡張されるかどうかを調べてから、 MultiCell メソッドの処理を変えたりするとかが、考えられます。 これに付いては別の機会に説明したいと思います。

また、上記のソースでは MultiCell メソッドの後で Rect メソッドで枠線を表示している関係上、 ページが移動してしまうので、強制的に1ページ目に戻る指定を行っています。

前回の 「PHP PDF出力の方法について・矩形領域への文字列出力（Cellメソッド）」 の記事では Cell メソッドを説明しましたが、今回はそれの拡張版といえる MultiCell メソッドについて説明します。

Cell と MultiCell の違いですが、以下のソースを動作させるとよくわかります。

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();

// border テスト
$pdf->Write(0, 'border テスト', '', false, '', true);
$pdf->Cell(50, 0, '$border [1]:枠有り012345678901234567890123456789'   , 1, 1);
$pdf->Ln();
$pdf->Cell(50, 0, "\$border [1]:枠有り\r\n012345678901234567890123456789"   , 1, 1);
$pdf->Ln();
$pdf->MultiCell(50, 0, "\$border [1]:枠有り\r\n012345678901234567890123456789"   , 1, 1);

// pdf表示設定
$pdf->Output('pdf4-1.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

これの実行結果は以下の通りです。
前回の Cell メソッドの記事の中のボーダー（枠線）の部分のソースを参考にしています。
20行目の文字列の中に改行コードを入れてみたのですが、実際に実行すると空白が2個挿入された感じになりました。 尚、18行目では文字列が枠をはみ出て表示されています。 Cell メソッドでは改行を考慮には入れていない様です。
そこで呼出しを MultiCell メソッドに変えてみますと、枠の中で改行がされています。 メソッドの中で上手く縦方向に伸ばしている様です。

MultiCell メソッドの引数は Cell メソッドとほぼ似た引数ですが 以下の様になっていますので、大まかに各引数について説明します。

// Cellメソッド
public function MultiCell($w, $h, $txt, $border=0, $align='J', $fill=false, $ln=1, $x=null, $y=null, 
                          $reseth=true, $stretch=0, $ishtml=false, $autopadding=true, $maxh=0, 
                          $valign='T', $fitcell=false)
// $w      : 矩形領域の幅、0であれば、右マージンまで自動的に拡張される。
// $h      : 矩形領域の最小の縦幅で自動的に拡張される
// $txt    : 表示文字列
// $border : 境界線表示（0:枠無し,1:枠有 または "LRTB"の文字列で「左右上下」を指定）
// $align  : テキストの整列を指定
//           [L] or 空文字: 左揃え
//           [C]: 中央揃え
//           [R]: 右揃え
//           [J]: 両端揃え ($ishtml=falseの場合の既定値)
// $fill   : 矩形領域の塗つぶし指定
//           [false] : 透明(既定)
//           [true]  : 塗つぶす
// $ln     : 出力後のカーソルの移動方法を指定
//           [0]: 右へ移動(既定)
//           [1]: 次の行へ移動
//           [2]: 下へ移動
// $x      : X座標(省略時は現在位置)
// $y      : Y座標(省略時は現在位置)
// $reseth : 前回セルの高さ設定リセット
//           [true] :リセットする
//           [false]:前回セルの高さを引き継ぐ
// $stretch: テキストの伸縮(ストレッチ)モード:
//           [0] : なし
//           [1] : 必要に応じて水平伸縮
//           [2] : 水平伸縮
//           [3] : 必要に応じてスペース埋め
//           [4] : スペース埋め
// $ishtml :「true」テキストがHTML
// $autopadding :「true」行幅に自動調整
// $maxh   : 高さの上限
// $valign : セルの中のテキストの垂直方向の配置
//           [T] : top
//           [M] : middle
//           [B] : bottom
// $fitcell: [true]セルの領域でフィットする様にフォントサイズを小さくする

• $border : 境界線表示
• $align : テキストの整列を指定
• $fill : 矩形領域の塗つぶし指定
• $stretch: テキストの伸縮(ストレッチ)モード指定
• $valign : テキストのセル位置、垂直方向指定

■$border : 境界線表示

境界線表示の引数「$border」は以下の様になっていますので、それぞれを順次テストしてみます。

• 数値(0):枠無し
• 数値(1):枠有り
• 文字列("LRTB"):枠線の「左右上下」を指定

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();
// border テスト
$pdf->Write(0, 'border テスト', '', false, '', true);
$strAdd = "\r\n".'012345678901234567890123456789';
$pdf->MultiCell(50, 0, '$border [0]:枠無し'.$strAdd             , 0     , 'J', false, 0,  10, 20);
$pdf->MultiCell(50, 0, '$border [1]:枠有り'.$strAdd             , 1     , 'J', false, 0,  70, 20);
$pdf->MultiCell(50, 0, '$border ["L"]:「左」枠'.$strAdd         , 'L'   , 'J', false, 0, 130, 20);
$pdf->MultiCell(50, 0, '$border ["LT"]:「左上」枠'.$strAdd      , 'LT'  , 'J', false, 0,  10, 40);
$pdf->MultiCell(50, 0, '$border ["LTR"]:「左上右」枠'.$strAdd   , 'LTR' , 'J', false, 0,  70, 40);
$pdf->MultiCell(50, 0, '$border ["LTRB"]:「左上右下」枠'.$strAdd, 'LTRB', 'J', false, 0, 130, 40);

// pdf表示設定
$pdf->Output('pdf4-2.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

これの実行結果は以下の通りです。

各「border」の説明テキストの後ろに改行コード（\r\n）と長い文字列を付加しています。 セルの横幅は「50」（mm）で指定していますが、改行コードで改行の動作が行われ、 横幅からあふれる場合には次の行に表示がされる様になっています。
各 MultiCell メソッドの引数のX座標、Y座標を指定してそれぞれの位置合わせを行っています。

■$align : テキストの整列を指定

テキストの整列の引数「$align」は以下の様になっていますので、それぞれを順次テストしてみます。

• 文字列("L"):左揃え
• 文字列("C"):中央揃え
• 文字列("R"):右揃え
• 文字列("J"):両端揃え

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();
// align テスト
$pdf->Write(0, 'align テスト', '', false, '', true);
$strAdd = "\r\n".'012345678901234567890123456789';
$pdf->MultiCell(50, 0, '$align["L"]:左揃え'  .$strAdd, 1, 'L', false, 0,  10, 20);
$pdf->MultiCell(50, 0, '$align["C"]:中央揃え'.$strAdd, 1, 'C', false, 0,  70, 20);
$pdf->MultiCell(50, 0, '$align["R"]:右揃え'  .$strAdd, 1, 'R', false, 0, 130, 20);
$pdf->MultiCell(50, 0, '$align["J"]:両端揃え A B C D E F G', 1, 'J', false, 0,  10, 40);
$pdf->MultiCell(50, 0, '$align["J"]:両端揃え ABCDE FGH IJK', 1, 'J', false, 0,  70, 40);

// pdf表示設定
$pdf->Output('pdf4-3.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

実行結果は以下の様な表示になるはずです。
「両端揃え」の指定は、表示文字列を空白で分解して均等割りで揃えるようです。
「両端揃え」を2種類表示しましたが、それぞれセルの横幅に合わせて最適な感じで表示している様です。

■$fill : 矩形領域の塗つぶし指定

矩形領域の塗つぶし指定の引数「$fill」は以下の様になっていますので、それぞれを順次テストしてみます。

• boolean値(false):塗つぶし無し
• boolean値(true) :塗つぶし有り

塗つぶしを行う場合は、塗りつぶしの色設定をしないと初期値（黒）のままで処理されるので SetFillColor メソッドで色設定を行います。
以下の例では RGB の指定で「128, 128, 128」なので濃い灰色な感じで塗りつぶしされます。

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();

// fill テスト
$pdf->Write(0, 'fill テスト', '', false, '', true);
$pdf->MultiCell(0, 0, '$fill [false]:矩形領域の塗つぶし無し'  , 1, "L", false);
$pdf->Ln();
// 塗つぶしの色指定:RGB[128, 128, 128]
$pdf->SetFillColor(128, 128, 128);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り'  , 1, "L", true);

// pdf表示設定
$pdf->Output('pdf4-4.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

実行結果は以下の様な表示になるはずです。

ちなみに SetFillColor メソッドの引数は、以下の様になっています。

public function setFillColor($col1=0, $col2=-1, $col3=-1, $col4=-1, $ret=false, $name='')
// $col1  : GRAYレベルの値、RGBのRed[0～255]、CMYKのCYAN[0～100]
// $col2  : RGBのGREEN[0～255]、CMYKのMAGENTA[0～100]
// $col3  : RGBのBlue[0～255]、CMYKのYELLOW[0～100]
// $col4  : CMYKのKEY(BLACK)[0～100]
// $ret   : [true]コマンドを送信しない
// $name  : 色名

この SetFillColor メソッドで「GRAYレベル」「RGB」「CMYK」の指定を行った例を以下に示します。

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();

// fill - SetFillColor GRAY テスト
$pdf->Write(0, 'fill - SetFillColor GRAY テスト', '', false, '', true);
$pdf->SetFillColor( 64);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor( 64)' , 1, "L", true);
$pdf->Ln();
$pdf->SetFillColor(128);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor(128)' , 1, "L", true);
$pdf->Ln();
$pdf->SetFillColor(192);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor(192)' , 1, "L", true);
$pdf->Ln();
$pdf->SetFillColor(240);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor(240)' , 1, "L", true);
$pdf->Ln();

// fill - SetFillColor RGB テスト
$pdf->Write(0, 'fill - SetFillColor RGB テスト', '', false, '', true);
$pdf->SetFillColor(128, 128, 128);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor(128, 128, 128)' , 1, "L", true);
$pdf->Ln();
$pdf->SetFillColor(255, 128, 128);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor(255, 128, 128)' , 1, "L", true);
$pdf->Ln();
$pdf->SetFillColor(128, 255, 128);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor(128, 255, 128)' , 1, "L", true);
$pdf->Ln();
$pdf->SetFillColor(128, 128, 255);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor(128, 128, 255)' , 1, "L", true);
$pdf->Ln();

// fill - SetFillColor CMYK テスト
$pdf->Write(0, 'fill - SetFillColor CMYK テスト', '', false, '', true);
$pdf->SetFillColor(100,   0,   0,   0);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor(100,   0,   0,   0)' , 1, "L", true);
$pdf->Ln();
$pdf->SetFillColor(  0, 100,   0,   0);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor(  0, 100,   0,   0)' , 1, "L", true);
$pdf->Ln();
$pdf->SetFillColor(  0,   0, 100,   0);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor(  0,   0, 100,   0)' , 1, "L", true);
$pdf->Ln();
$pdf->SetFillColor(  0,   0,   0,  20);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor(  0,   0,   0,  20)' , 1, "L", true);
$pdf->Ln();
$pdf->SetFillColor( 50,  10,  20,  10);
$pdf->MultiCell(0, 0, '$fill [true] :矩形領域の塗つぶし有り:setFillColor( 50,  10,  20,  10)' , 1, "L", true);
$pdf->Ln();

// pdf表示設定
$pdf->Output('pdf4-5.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

実行結果は以下の様になります。

■$stretch: テキストの伸縮(ストレッチ)モード指定

テキストの伸縮(ストレッチ)モード指定の引数「$stretch」は以下の様になっていますので、それぞれを順次テストしてみます。

• 数値(0):なし
• 数値(1):必要に応じて水平伸縮
• 数値(2):水平伸縮
• 数値(3):必要に応じてスペース埋め
• 数値(4):スペース埋め

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();

// stretch テスト
$pdf->Write(0, 'stretch テスト', '', false, '', true);
$pdf->MultiCell(0, 0, '$stretch[0]:ストレッチ:無し'                , 1, "C", false, 1, null, null, true, 0);
$pdf->Ln();
$pdf->MultiCell(0, 0, '$stretch[1]:ストレッチ:必要に応じて水平伸縮', 1, "C", false, 1, null, null, true, 1);
$pdf->Ln();
$pdf->MultiCell(0, 0, '$stretch[2]:ストレッチ:水平伸縮'            , 1, "C", false, 1, null, null, true, 2);
$pdf->Ln();
$pdf->MultiCell(0, 0, '$stretch[3]:ストレッチ:必要に応じて空白埋め', 1, "C", false, 1, null, null, true, 3);
$pdf->Ln();
$pdf->MultiCell(0, 0, '$stretch[3]:ストレッチ:空白埋め'            , 1, "C", false, 1, null, null, true, 4);
$pdf->Ln();

// pdf表示設定
$pdf->Output('pdf4-6.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

実行結果は以下の様な表示になるはずです。

■$valign : テキストのセル位置、垂直方向指定

セルの中のテキストの垂直方向の配置の引数「$valign」は以下の様になっています。

• 文字列("T"):top
• 文字列("M"):middle
• 文字列("B"):bottom

<?php
require_once('../tcpdf/tcpdf.php');
// クラス生成
$pdf = new TCPDF();
// デフォルトで用意されている日本語フォント[小塚ゴシックPro M]
$strFont = "kozgopromedium";
// ヘッダ・フッタ出力設定(特にいらないが)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// 本文の日本語フォント[小塚ゴシックPro M]
$pdf->SetFont($strFont, "", 10);

// 新しいpdfページを追加
$pdf->AddPage();
// valign テスト
$pdf->Write(0, 'valign テスト', '', false, '', true);
$strAdd = "\r\n0123456789\r\n0123456789";

$strTxt = "\$valign['T']:Top   \r\n\$align['L']左揃え"  .$strAdd;
$pdf->MultiCell(60, 60, $strTxt, 1, 'L', false, 1,  10, 20, true, 0, false, true, 60,'T');

$strTxt = "\$valign['M']:Middle\r\n\$align['C']中央揃え".$strAdd;
$pdf->MultiCell(60, 60, $strTxt, 1, 'C', false, 1,  75, 20, true, 0, false, true, 60,'M');

$strTxt = "\$valign['B']:Bottom\r\n\$align['R']右揃え"  .$strAdd;
$pdf->MultiCell(60, 60, $strTxt, 1, 'R', false, 1, 140, 20, true, 0, false, true, 60,'B');

// pdf表示設定
$pdf->Output('pdf4-7.pdf', 'I');  // 'I':ブラウザに出力する(既定)
?>

なお、「$maxh」は「$h」と同じ値にしてあります。この値が「0」ではうまく表示されません。
あと「$ishtml」ですがテキストの中に改行コードを入れる場合は「false」で指定し、 テキストが HTML で改行が <BR> の場合は「true」で指定します。
実行結果は以下の様な表示になるはずです。