$_data
$_data : string
The string containing the data of the BIFF stream
PHPExcel_Writer_Excel5_Worksheet
$_data : string
The string containing the data of the BIFF stream
$_datasize : int
The size of the data in bytes. Should be the same as strlen($this->_data)
$_limit : int
The maximum length for a BIFF record (excluding record header and length field). See _addContinue()
$_xls_strmax : int
Maximum number of characters for a string (LABEL record in BIFF5)
$_colinfo : array
Array containing format information for columns
$_selection : array
Array containing the selected area for the worksheet
$_active_pane : int
The active pane for the worksheet
$_outline_on : int
Whether to use outline.
$_outline_style : bool
Auto outline styles.
$_outline_below : bool
Whether to have outline summary below.
$_outline_right : bool
Whether to have outline summary at the right.
$_str_total : int
Reference to the total number of strings in the workbook
$_str_unique : int
Reference to the number of unique strings in the workbook
$_str_table : array
Reference to the array containing all the unique strings in the workbook
$_phpSheet : \PHPExcel_Worksheet
Sheet object
$_fntHashIndex : array
Array of font hashes associated to FONT records index
$_byte_order : int
The byte order of this architecture. 0 => little endian, 1 => big endian
$_parser : \PHPExcel_Writer_Excel5_Parser
Formula parser
$_firstRowIndex : int
Index of first used row (at least 0)
$_lastRowIndex : int
Index of last used row. (no used rows means -1)
$_firstColumnIndex : int
Index of first used column (at least 0)
$_lastColumnIndex : int
Index of last used column (no used columns means -1)
$_countCellStyleXfs : int
Count cell style Xfs
$_escher : \PHPExcel_Shared_Escher
Escher object corresponding to MSODRAWING
__construct(int $str_total, int $str_unique, array $str_table, array $colors, mixed $parser, bool $preCalculateFormulas, \PHPExcel_Worksheet $phpSheet) : mixed
Constructor
| int | $str_total | Total number of strings |
| int | $str_unique | Total number of unique strings |
| array | $str_table | String Table |
| array | $colors | Colour Table |
| mixed | $parser | The formula parser created for the Workbook |
| bool | $preCalculateFormulas | Flag indicating whether formulas should be calculated or just written |
| \PHPExcel_Worksheet | $phpSheet |
_addContinue(string $data) : string
Excel limits the size of BIFF records. In Excel 5 the limit is 2084 bytes. In Excel 97 the limit is 8228 bytes. Records that are longer than these limits must be split up into CONTINUE blocks.
This function takes a long BIFF record and inserts CONTINUE records as necessary.
| string | $data | The original binary data to be written |
A very convenient string of continue blocks
setOutline(bool $visible = true, bool $symbols_below = true, bool $symbols_right = true, bool $auto_style = false) : mixed
This method sets the properties for outlining and grouping. The defaults correspond to Excel's defaults.
| bool | $visible | |
| bool | $symbols_below | |
| bool | $symbols_right | |
| bool | $auto_style |
_writeBlank(int $row, int $col, mixed $xfIndex) : mixed
Write a blank cell to the specified row and column (zero indexed).
A blank cell is used to specify formatting without adding a string or a number.
A blank cell without a format serves no purpose. Therefore, we don't write a BLANK record unless a format is specified.
Returns 0 : normal termination (including no format) -1 : insufficient number of arguments -2 : row or column out of range
| int | $row | Zero indexed row |
| int | $col | Zero indexed column |
| mixed | $xfIndex | The XF format index |
_writeUrlRange(int $row1, int $col1, int $row2, int $col2, string $url) : int
This is the more general form of _writeUrl(). It allows a hyperlink to be written to a range of cells. This function also decides the type of hyperlink to be written. These are either, Web (http, ftp, mailto), Internal (Sheet1!A1) or external ('c:\temp\foo.xls#Sheet1!A1').
| int | $row1 | Start row |
| int | $col1 | Start column |
| int | $row2 | End row |
| int | $col2 | End column |
| string | $url | URL string |
_writeUrlWeb(int $row1, int $col1, int $row2, int $col2, string $url) : int
Used to write http, ftp and mailto hyperlinks.
The link type ($options) is 0x03 is the same as absolute dir ref without sheet. However it is differentiated by the $unknown2 data stream.
| int | $row1 | Start row |
| int | $col1 | Start column |
| int | $row2 | End row |
| int | $col2 | End column |
| string | $url | URL string |
_writeUrlExternal(int $row1, int $col1, int $row2, int $col2, string $url) : int
Write links to external directory names such as 'c:\foo.xls', c:\foo.xls#Sheet1!A1', '../../foo.xls'. and '../../foo.xls#Sheet1!A1'.
Note: Excel writes some relative links with the $dir_long string. We ignore these cases for the sake of simpler code.
| int | $row1 | Start row |
| int | $col1 | Start column |
| int | $row2 | End row |
| int | $col2 | End column |
| string | $url | URL string |
insertBitmap(int $row, int $col, mixed $bitmap, int $x, int $y, float $scale_x = 1, float $scale_y = 1) : mixed
Insert a 24bit bitmap image in a worksheet.
| int | $row | The row we are going to insert the bitmap into |
| int | $col | The column we are going to insert the bitmap into |
| mixed | $bitmap | The bitmap filename or GD-image resource |
| int | $x | The horizontal position (offset) of the image inside the cell. |
| int | $y | The vertical position (offset) of the image inside the cell. |
| float | $scale_x | The horizontal scale |
| float | $scale_y | The vertical scale |
_positionImage(int $col_start, int $row_start, int $x1, int $y1, int $width, int $height) : mixed
Calculate the vertices that define the position of the image as required by the OBJ record.
+------------+------------+ | A | B | +-----+------------+------------+ | |(x1,y1) | | | 1 |(A1)._| | | | | | | | | | | | +-----+----| BITMAP |-----+ | | | | | | 2 | |______________. | | | | (B2)| | | | (x2,y2)| +---- +------------+------------+
Example of a bitmap that covers some of the area from cell A1 to cell B2.
Based on the width and height of the bitmap we need to calculate 8 vars: $col_start, $row_start, $col_end, $row_end, $x1, $y1, $x2, $y2. The width and height of the cells are also variable and have to be taken into account. The values of $col_start and $row_start are passed in from the calling function. The values of $col_end and $row_end are calculated by subtracting the width and height of the bitmap from the width and height of the underlying cells. The vertices are expressed as a percentage of the underlying cell width as follows (rhs values are in pixels):
x1 = X / W *1024 y1 = Y / H *256 x2 = (X-1) / W *1024 y2 = (Y-1) / H *256
Where: X is distance from the left side of the underlying cell Y is distance from the top of the underlying cell W is the width of the cell H is the height of the cell The SDK incorrectly states that the height should be expressed as a percentage of 1024.
| int | $col_start | Col containing upper left corner of object |
| int | $row_start | Row containing top left corner of object |
| int | $x1 | Distance to left side of object |
| int | $y1 | Distance to top of object |
| int | $width | Width of image frame |
| int | $height | Height of image frame |
_processBitmap(string $bitmap) : array
Convert a 24 bit bitmap into the modified internal format used by Windows.
This is described in BITMAPCOREHEADER and BITMAPCOREINFO structures in the MSDN library.
| string | $bitmap | The bitmap to process |
Array with data and properties of the bitmap
_writeBIFF8CellRangeAddressFixed(string $range = 'A1') : string
Write a cell range address in BIFF8 always fixed range See section 2.5.14 in OpenOffice.org's Documentation of the Microsoft Excel File Format
| string | $range | E.g. 'A1' or 'A1:B6' |
Binary data
_writeNumber(int $row, int $col, float $num, mixed $xfIndex) : int
Write a double to the specified row and column (zero indexed).
An integer can be written as a double. Excel will display an integer. $format is optional.
Returns 0 : normal termination -2 : row or column out of range
| int | $row | Zero indexed row |
| int | $col | Zero indexed column |
| float | $num | The number to write |
| mixed | $xfIndex | The optional XF format |
_writeString(int $row, int $col, string $str, int $xfIndex) : mixed
Write a LABELSST record or a LABEL record. Which one depends on BIFF version
| int | $row | Row index (0-based) |
| int | $col | Column index (0-based) |
| string | $str | The string |
| int | $xfIndex | Index to XF record |
_writeRichTextString(int $row, int $col, string $str, mixed $xfIndex, array $arrcRun) : mixed
Write a LABELSST record or a LABEL record. Which one depends on BIFF version It differs from _writeString by the writing of rich text strings.
| int | $row | Row index (0-based) |
| int | $col | Column index (0-based) |
| string | $str | The string |
| mixed | $xfIndex | The XF format index for the cell |
| array | $arrcRun | Index to Font record and characters beginning |
_writeLabel(int $row, int $col, string $str, mixed $xfIndex) : int
Write a string to the specified row and column (zero indexed).
NOTE: there is an Excel 5 defined limit of 255 characters. $format is optional. Returns 0 : normal termination -2 : row or column out of range -3 : long string truncated to 255 chars
| int | $row | Zero indexed row |
| int | $col | Zero indexed column |
| string | $str | The string to write |
| mixed | $xfIndex | The XF format index for the cell |
_writeLabelSst(int $row, int $col, string $str, mixed $xfIndex) : int
Write a string to the specified row and column (zero indexed).
This is the BIFF8 version (no 255 chars limit). $format is optional. Returns 0 : normal termination -2 : row or column out of range -3 : long string truncated to 255 chars
| int | $row | Zero indexed row |
| int | $col | Zero indexed column |
| string | $str | The string to write |
| mixed | $xfIndex | The XF format index for the cell |
_writeBoolErr(int $row, int $col, int $value, bool $isError, int $xfIndex) : mixed
Write a boolean or an error type to the specified row and column (zero indexed)
| int | $row | Row index (0-based) |
| int | $col | Column index (0-based) |
| int | $value | |
| bool | $isError | Error or Boolean? |
| int | $xfIndex |
_writeFormula(int $row, int $col, string $formula, mixed $xfIndex, mixed $calculatedValue) : int
Write a formula to the specified row and column (zero indexed).
The textual representation of the formula is passed to the parser in Parser.php which returns a packed binary string.
Returns 0 : normal termination -1 : formula errors (bad formula) -2 : row or column out of range
| int | $row | Zero indexed row |
| int | $col | Zero indexed column |
| string | $formula | The formula text string |
| mixed | $xfIndex | The XF format index |
| mixed | $calculatedValue | Calculated value |
_writeUrl(int $row, int $col, string $url) : int
Write a hyperlink.
This is comprised of two elements: the visible label and the invisible link. The visible label is the same as the link unless an alternative string is specified. The label is written using the _writeString() method. Therefore the 255 characters string limit applies. $string and $format are optional.
The hyperlink can be to a http, ftp, mail, internal sheet (not yet), or external directory url.
Returns 0 : normal termination -2 : row or column out of range -3 : long string truncated to 255 chars
| int | $row | Row |
| int | $col | Column |
| string | $url | URL string |
_writeRow(int $row, int $height, int $xfIndex, bool $hidden = false, int $level) : mixed
This method is used to set the height and format for a row.
| int | $row | The row to set |
| int | $height | Height we are giving to the row. Use null to set XF without setting height |
| int | $xfIndex | The optional cell style Xf index to apply to the columns |
| bool | $hidden | The optional hidden attribute |
| int | $level | The optional outline level for row, in range [0,7] |
_writeColinfo(array $col_array) : mixed
Write BIFF record COLINFO to define column widths
Note: The SDK says the record length is 0x0B but Excel writes a 0x0C length record.
| array | $col_array | This is the only parameter received and is composed of the following: 0 => First formatted column, 1 => Last formatted column, 2 => Col width (8.43 is Excel default), 3 => The optional XF format of the column, 4 => Option flags. 5 => Optional outline level |
_writeRangeProtection() : mixed
Write BIFF record RANGEPROTECTION
Openoffice.org's Documentaion of the Microsoft Excel File Format uses term RANGEPROTECTION for these records Microsoft Office Excel 97-2007 Binary File Format Specification uses term FEAT for these records
_writeExterncount(int $count) : mixed
Write BIFF record EXTERNCOUNT to indicate the number of external sheet references in a worksheet.
Excel only stores references to external sheets that are used in formulas. For simplicity we store references to all the sheets in the workbook regardless of whether they are used or not. This reduces the overall complexity and eliminates the need for a two way dialogue between the formula parser the worksheet objects.
| int | $count | The number of external sheet references in this worksheet |
_writeExternsheet(string $sheetname) : mixed
Writes the Excel BIFF EXTERNSHEET record. These references are used by formulas. A formula references a sheet name via an index. Since we store a reference to all of the external worksheets the EXTERNSHEET index is the same as the worksheet index.
| string | $sheetname | The name of a external worksheet |
_writeObjPicture(int $colL, int $dxL, int $rwT, int $dyT, int $colR, int $dxR, int $rwB, int $dyB) : mixed
Store the OBJ record that precedes an IMDATA record. This could be generalise to support other Excel objects.
| int | $colL | Column containing upper left corner of object |
| int | $dxL | Distance from left side of cell |
| int | $rwT | Row containing top left corner of object |
| int | $dyT | Distance from top of cell |
| int | $colR | Column containing lower right corner of object |
| int | $dxR | Distance from right of cell |
| int | $rwB | Row containing bottom right corner of object |
| int | $dyB | Distance from bottom of cell |