Worksheet::writeBlank
Worksheet::writeBlank – 指定した行・列 (ゼロから数える) に空のセルを書き込む
Synopsis
require_once "Spreadsheet/Excel/Writer.php";
void Worksheet::writeBlank (
integer $row
,
integer $col
,
mixed $format
)
Description
指定した行・列 (ゼロから数える) に空のセルを書き込みます。 空のセルは、文字や数値を書き込まずに書式だけを設定する場合に使用します。 書式を設定せずに空のセルを書き込んでも何の意味もありません。 そのため、書式を指定していない場合はこのメソッドは何も書き込みません。 これは、主に write_row() および write_col() メソッドの最適化のためです。 正常に終了した場合 (書式を指定しなかった場合も含む) に 0、 パラメータが足りない場合に -1、 行や列が範囲を超えている場合に -2 を返します。
Parameter
-
integer $row - ゼロから数えた行番号。
-
integer $col - ゼロから数えた列番号。
-
mixed $format - XF フォーマット。
Note
This function can not be called statically.
Example
writeBlank() の使用法
<?php
require_once 'Spreadsheet/Excel/Writer.php';
$workbook = new Spreadsheet_Excel_Writer();
$worksheet =& $workbook->addWorksheet();
// すべてのプロパティを一気に設定することが可能です
$upper_right_side_brick =& $workbook->addFormat(array('right' => 5, 'top' => 5, 'size' => 15,
'pattern' => 1, 'bordercolor' => 'blue',
'fgcolor' => 'red'));
// あるいは、すべてのプロパティをひとつづつ設定していくことも可能です
$upper_left_side_brick =& $workbook->addFormat();
$upper_left_side_brick->setLeft(5);
$upper_left_side_brick->setTop(5);
$upper_left_side_brick->setSize(15);
$upper_left_side_brick->setPattern(1);
$upper_left_side_brick->setBorderColor('blue');
$upper_left_side_brick->setFgColor('red');
$lower_right_side_brick =& $workbook->addFormat(array('right' => 5, 'bottom' => 5, 'size' => 15,
'pattern' => 1, 'bordercolor' => 'blue',
'fgcolor' => 'red'));
$lower_left_side_brick =& $workbook->addFormat(array('left' => 5, 'bottom' => 5, 'size' => 15,
'pattern' => 1, 'bordercolor' => 'blue',
'fgcolor' => 'red'));
$worksheet->setColumn(0, 20, 6);
// 空
$sky =& $workbook->addFormat(array('fgcolor' => 'cyan', 'pattern' => 1, 'size' => 15));
for ($i = 0; $i <= 10; $i++)
{
for ($j = 0; $j < 20; $j++) {
$worksheet->writeBlank($i, $j, $sky);
}
}
// 雲
$cloud =& $workbook->addFormat(array('fgcolor' => 'white', 'pattern' => 1, 'size' => 15));
$worksheet->writeBlank(5, 7, $cloud);
$worksheet->writeBlank(4, 8, $cloud);
$worksheet->writeBlank(5, 8, $cloud);
$worksheet->writeBlank(6, 8, $cloud);
$worksheet->writeBlank(4, 9, $cloud);
$worksheet->writeBlank(5, 9, $cloud);
$worksheet->writeBlank(5, 10, $cloud);
// レンガ
for ($j = 0; $j < 20; $j++)
{
for ($i = 5; $i <= 11; $i++)
{
if (($i + $j)%2 == 1) // 右側
{
$worksheet->writeBlank(2*$i, $j, $upper_right_side_brick);
$worksheet->writeBlank(2*$i + 1, $j, $lower_right_side_brick);
}
else // 左側
{
$worksheet->writeBlank(2*$i, $j, $upper_left_side_brick);
$worksheet->writeBlank(2*$i + 1, $j, $lower_left_side_brick);
}
}
}
// この Excel アートを台無しにしないために、枠線を非表示にします。
$worksheet->hideGridLines();
$workbook->send('bricks.xls');
$workbook->close();
?>
忘却曲線を使ってこの知識を確実に記憶に残す
