PHPExcel_Worksheet

# Source for file HeaderFooter.php Documentation is available at HeaderFooter.php <?php /** * PHPExcel * * Copyright (c) 2006 - 2010 PHPExcel * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA * * @category PHPExcel * @package PHPExcel_Worksheet * @copyright Copyright (c) 2006 - 2010 PHPExcel (http://www.codeplex.com/PHPExcel) * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL * @version 1.7.2, 2010-01-11 */ /** PHPExcel root directory */ if (!defined('PHPEXCEL_ROOT')) { /** * @ignore */ define('PHPEXCEL_ROOT', dirname(__FILE__) . '/../../'); } /** PHPExcel_Worksheet_HeaderFooterDrawing */ require_once PHPEXCEL_ROOT . 'PHPExcel/Worksheet/HeaderFooterDrawing.php'; /** * PHPExcel_Worksheet_HeaderFooter * * <code> * Header/Footer Formatting Syntax taken from Office Open XML Part 4 - Markup Language Reference, page 1970: * * There are a number of formatting codes that can be written inline with the actual header / footer text, which * affect the formatting in the header or footer. * * Example: This example shows the text "Center Bold Header" on the first line (center section), and the date on * the second line (center section). * &CCenter &"-,Bold"Bold&"-,Regular"Header_x000A_&D * * General Rules: * There is no required order in which these codes must appear. * * The first occurrence of the following codes turns the formatting ON, the second occurrence turns it OFF again: * - strikethrough * - superscript * - subscript * Superscript and subscript cannot both be ON at same time. Whichever comes first wins and the other is ignored, * while the first is ON. * &L - code for "left section" (there are three header / footer locations, "left", "center", and "right"). When * two or more occurrences of this section marker exist, the contents from all markers are concatenated, in the * order of appearance, and placed into the left section. * &P - code for "current page #" * &N - code for "total pages" * &font size - code for "text font size", where font size is a font size in points. * &K - code for "text font color" * RGB Color is specified as RRGGBB * Theme Color is specifed as TTSNN where TT is the theme color Id, S is either "+" or "-" of the tint/shade * value, NN is the tint/shade value. * &S - code for "text strikethrough" on / off * &X - code for "text super script" on / off * &Y - code for "text subscript" on / off * &C - code for "center section". When two or more occurrences of this section marker exist, the contents * from all markers are concatenated, in the order of appearance, and placed into the center section. * * &D - code for "date" * &T - code for "time" * &G - code for "picture as background" * &U - code for "text single underline" * &E - code for "double underline" * &R - code for "right section". When two or more occurrences of this section marker exist, the contents * from all markers are concatenated, in the order of appearance, and placed into the right section. * &Z - code for "this workbook's file path" * &F - code for "this workbook's file name" * &A - code for "sheet tab name" * &+ - code for add to page #. * &- - code for subtract from page #. * &"font name,font type" - code for "text font name" and "text font type", where font name and font type * are strings specifying the name and type of the font, separated by a comma. When a hyphen appears in font * name, it means "none specified". Both of font name and font type can be localized values. * &"-,Bold" - code for "bold font style" * &B - also means "bold font style". * &"-,Regular" - code for "regular font style" * &"-,Italic" - code for "italic font style" * &I - also means "italic font style" * &"-,Bold Italic" code for "bold italic font style" * &O - code for "outline style" * &H - code for "shadow style" * </code> * * @category PHPExcel * @package PHPExcel_Worksheet * @copyright Copyright (c) 2006 - 2010 PHPExcel (http://www.codeplex.com/PHPExcel) */ class PHPExcel_Worksheet_HeaderFooter { /* Header/footer image location */ const IMAGE_HEADER_LEFT = 'LH'; const IMAGE_HEADER_CENTER = 'CH'; const IMAGE_HEADER_RIGHT = 'RH'; const IMAGE_FOOTER_LEFT = 'LF'; const IMAGE_FOOTER_CENTER = 'CF'; const IMAGE_FOOTER_RIGHT = 'RF'; /** * OddHeader * * @var string */ private $_oddHeader; /** * OddFooter * * @var string */ private $_oddFooter; /** * EvenHeader * * @var string */ private $_evenHeader; /** * EvenFooter * * @var string */ private $_evenFooter; /** * FirstHeader * * @var string */ private $_firstHeader; /** * FirstFooter * * @var string */ private $_firstFooter; /** * Different header for Odd/Even, defaults to false * * @var boolean */ private $_differentOddEven; /** * Different header for first page, defaults to false * * @var boolean */ private $_differentFirst; /** * Scale with document, defaults to true * * @var boolean */ private $_scaleWithDocument; /** * Align with margins, defaults to true * * @var boolean */ private $_alignWithMargins; /** * Header/footer images * * @var PHPExcel_Worksheet_HeaderFooterDrawing[] */ private $_headerFooterImages = array(); /** * Create a new PHPExcel_Worksheet_HeaderFooter */ public function __construct() { // Initialise values $this->_oddHeader = ''; $this->_oddFooter = ''; $this->_evenHeader = ''; $this->_evenFooter = ''; $this->_firstHeader = ''; $this->_firstFooter = ''; $this->_differentOddEven = false; $this->_differentFirst = false; $this->_scaleWithDocument = true; $this->_alignWithMargins = true; $this->_headerFooterImages = array(); } /** * Get OddHeader * * @return string */ public function getOddHeader() { return $this->_oddHeader; } /** * Set OddHeader * * @param string $pValue * @return PHPExcel_Worksheet_HeaderFooter */ public function setOddHeader($pValue) { $this->_oddHeader = $pValue; return $this; } /** * Get OddFooter * * @return string */ public function getOddFooter() { return $this->_oddFooter; } /** * Set OddFooter * * @param string $pValue * @return PHPExcel_Worksheet_HeaderFooter */ public function setOddFooter($pValue) { $this->_oddFooter = $pValue; return $this; } /** * Get EvenHeader * * @return string */ public function getEvenHeader() { return $this->_evenHeader; } /** * Set EvenHeader * * @param string $pValue * @return PHPExcel_Worksheet_HeaderFooter */ public function setEvenHeader($pValue) { $this->_evenHeader = $pValue; return $this; } /** * Get EvenFooter * * @return string */ public function getEvenFooter() { return $this->_evenFooter; } /** * Set EvenFooter * * @param string $pValue * @return PHPExcel_Worksheet_HeaderFooter */ public function setEvenFooter($pValue) { $this->_evenFooter = $pValue; return $this; } /** * Get FirstHeader * * @return string */ public function getFirstHeader() { return $this->_firstHeader; } /** * Set FirstHeader * * @param string $pValue * @return PHPExcel_Worksheet_HeaderFooter */ public function setFirstHeader($pValue) { $this->_firstHeader = $pValue; return $this; } /** * Get FirstFooter * * @return string */ public function getFirstFooter() { return $this->_firstFooter; } /** * Set FirstFooter * * @param string $pValue * @return PHPExcel_Worksheet_HeaderFooter */ public function setFirstFooter($pValue) { $this->_firstFooter = $pValue; return $this; } /** * Get DifferentOddEven * * @return boolean */ public function getDifferentOddEven() { return $this->_differentOddEven; } /** * Set DifferentOddEven * * @param boolean $pValue * @return PHPExcel_Worksheet_HeaderFooter */ public function setDifferentOddEven($pValue = false) { $this->_differentOddEven = $pValue; return $this; } /** * Get DifferentFirst * * @return boolean */ public function getDifferentFirst() { return $this->_differentFirst; } /** * Set DifferentFirst * * @param boolean $pValue * @return PHPExcel_Worksheet_HeaderFooter */ public function setDifferentFirst($pValue = false) { $this->_differentFirst = $pValue; return $this; } /** * Get ScaleWithDocument * * @return boolean */ public function getScaleWithDocument() { return $this->_scaleWithDocument; } /** * Set ScaleWithDocument * * @param boolean $pValue * @return PHPExcel_Worksheet_HeaderFooter */ public function setScaleWithDocument($pValue = true) { $this->_scaleWithDocument = $pValue; return $this; } /** * Get AlignWithMargins * * @return boolean */ public function getAlignWithMargins() { return $this->_alignWithMargins; } /** * Set AlignWithMargins * * @param boolean $pValue * @return PHPExcel_Worksheet_HeaderFooter */ public function setAlignWithMargins($pValue = true) { $this->_alignWithMargins = $pValue; return $this; } /** * Add header/footer image * * @param PHPExcel_Worksheet_HeaderFooterDrawing $image * @param string $location * @throws Exception * @return PHPExcel_Worksheet_HeaderFooter */ public function addImage(PHPExcel_Worksheet_HeaderFooterDrawing $image = null, $location = self::IMAGE_HEADER_LEFT) { $this->_headerFooterImages[$location] = $image; return $this; } /** * Remove header/footer image * * @param string $location * @throws Exception * @return PHPExcel_Worksheet_HeaderFooter */ public function removeImage($location = self::IMAGE_HEADER_LEFT) { if (isset($this->_headerFooterImages[$location])) { unset($this->_headerFooterImages[$location]); } return $this; } /** * Set header/footer images * * @param PHPExcel_Worksheet_HeaderFooterDrawing[] $images * @throws Exception * @return PHPExcel_Worksheet_HeaderFooter */ public function setImages($images) { if (!is_array($images)) { throw new Exception('Invalid parameter!'); } $this->_headerFooterImages = $images; return $this; } /** * Get header/footer images * * @return PHPExcel_Worksheet_HeaderFooterDrawing[] */ public function getImages() { // Sort array $images = array(); if (isset($this->_headerFooterImages[self::IMAGE_HEADER_LEFT])) $images[self::IMAGE_HEADER_LEFT] = $this->_headerFooterImages[self::IMAGE_HEADER_LEFT]; if (isset($this->_headerFooterImages[self::IMAGE_HEADER_CENTER])) $images[self::IMAGE_HEADER_CENTER] = $this->_headerFooterImages[self::IMAGE_HEADER_CENTER]; if (isset($this->_headerFooterImages[self::IMAGE_HEADER_RIGHT])) $images[self::IMAGE_HEADER_RIGHT] = $this->_headerFooterImages[self::IMAGE_HEADER_RIGHT]; if (isset($this->_headerFooterImages[self::IMAGE_FOOTER_LEFT])) $images[self::IMAGE_FOOTER_LEFT] = $this->_headerFooterImages[self::IMAGE_FOOTER_LEFT]; if (isset($this->_headerFooterImages[self::IMAGE_FOOTER_CENTER])) $images[self::IMAGE_FOOTER_CENTER] = $this->_headerFooterImages[self::IMAGE_FOOTER_CENTER]; if (isset($this->_headerFooterImages[self::IMAGE_FOOTER_RIGHT])) $images[self::IMAGE_FOOTER_RIGHT] = $this->_headerFooterImages[self::IMAGE_FOOTER_RIGHT]; $this->_headerFooterImages = $images; return $this->_headerFooterImages; } /** * Implement PHP __clone to create a deep clone, not just a shallow copy. */ public function __clone() { $vars = get_object_vars($this); foreach ($vars as $key => $value) { if (is_object($value)) { $this->$key = clone $value; } else { $this->$key = $value; } } } } Documentation generated on Mon, 11 Jan 2010 08:11:14 +0100 by phpDocumentor 1.4.1