PhpSpreadsheet/Classes/PHPExcel/Shared/Escher/DgContainer/SpgrContainer/SpContainer.php

<?php
/**
 * PHPExcel
 *
 * Copyright (c) 2006 - 2015 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_Shared_Escher
 * @copyright  Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
 * @license    http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt    LGPL
 * @version    ##VERSION##, ##DATE##
 */

/**
 * PHPExcel_Shared_Escher_DgContainer_SpgrContainer_SpContainer
 *
 * @category   PHPExcel
 * @package    PHPExcel_Shared_Escher
 * @copyright  Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
 */
class PHPExcel_Shared_Escher_DgContainer_SpgrContainer_SpContainer
{
    /**
     * Parent Shape Group Container
     *
     * @var PHPExcel_Shared_Escher_DgContainer_SpgrContainer
     */
    private $_parent;

    /**
     * Is this a group shape?
     *
     * @var boolean
     */
    private $_spgr = false;

    /**
     * Shape type
     *
     * @var int
     */
    private $_spType;

    /**
     * Shape flag
     *
     * @var int
     */
    private $_spFlag;

    /**
     * Shape index (usually group shape has index 0, and the rest: 1,2,3...)
     *
     * @var boolean
     */
    private $_spId;

    /**
     * Array of options
     *
     * @var array
     */
    private $_OPT;

    /**
     * Cell coordinates of upper-left corner of shape, e.g. 'A1'
     *
     * @var string
     */
    private $_startCoordinates;

    /**
     * Horizontal offset of upper-left corner of shape measured in 1/1024 of column width
     *
     * @var int
     */
    private $_startOffsetX;

    /**
     * Vertical offset of upper-left corner of shape measured in 1/256 of row height
     *
     * @var int
     */
    private $_startOffsetY;

    /**
     * Cell coordinates of bottom-right corner of shape, e.g. 'B2'
     *
     * @var string
     */
    private $_endCoordinates;

    /**
     * Horizontal offset of bottom-right corner of shape measured in 1/1024 of column width
     *
     * @var int
     */
    private $_endOffsetX;

    /**
     * Vertical offset of bottom-right corner of shape measured in 1/256 of row height
     *
     * @var int
     */
    private $_endOffsetY;

    /**
     * Set parent Shape Group Container
     *
     * @param PHPExcel_Shared_Escher_DgContainer_SpgrContainer $parent
     */
    public function setParent($parent)
    {
        $this->_parent = $parent;
    }

    /**
     * Get the parent Shape Group Container
     *
     * @return PHPExcel_Shared_Escher_DgContainer_SpgrContainer
     */
    public function getParent()
    {
        return $this->_parent;
    }

    /**
     * Set whether this is a group shape
     *
     * @param boolean $value
     */
    public function setSpgr($value = false)
    {
        $this->_spgr = $value;
    }

    /**
     * Get whether this is a group shape
     *
     * @return boolean
     */
    public function getSpgr()
    {
        return $this->_spgr;
    }

    /**
     * Set the shape type
     *
     * @param int $value
     */
    public function setSpType($value)
    {
        $this->_spType = $value;
    }

    /**
     * Get the shape type
     *
     * @return int
     */
    public function getSpType()
    {
        return $this->_spType;
    }

    /**
     * Set the shape flag
     *
     * @param int $value
     */
    public function setSpFlag($value)
    {
        $this->_spFlag = $value;
    }

    /**
     * Get the shape flag
     *
     * @return int
     */
    public function getSpFlag()
    {
        return $this->_spFlag;
    }

    /**
     * Set the shape index
     *
     * @param int $value
     */
    public function setSpId($value)
    {
        $this->_spId = $value;
    }

    /**
     * Get the shape index
     *
     * @return int
     */
    public function getSpId()
    {
        return $this->_spId;
    }

    /**
     * Set an option for the Shape Group Container
     *
     * @param int $property The number specifies the option
     * @param mixed $value
     */
    public function setOPT($property, $value)
    {
        $this->_OPT[$property] = $value;
    }

    /**
     * Get an option for the Shape Group Container
     *
     * @param int $property The number specifies the option
     * @return mixed
     */
    public function getOPT($property)
    {
        if (isset($this->_OPT[$property])) {
            return $this->_OPT[$property];
        }
        return null;
    }

    /**
     * Get the collection of options
     *
     * @return array
     */
    public function getOPTCollection()
    {
        return $this->_OPT;
    }

    /**
     * Set cell coordinates of upper-left corner of shape
     *
     * @param string $value
     */
    public function setStartCoordinates($value = 'A1')
    {
        $this->_startCoordinates = $value;
    }

    /**
     * Get cell coordinates of upper-left corner of shape
     *
     * @return string
     */
    public function getStartCoordinates()
    {
        return $this->_startCoordinates;
    }

    /**
     * Set offset in x-direction of upper-left corner of shape measured in 1/1024 of column width
     *
     * @param int $startOffsetX
     */
    public function setStartOffsetX($startOffsetX = 0)
    {
        $this->_startOffsetX = $startOffsetX;
    }

    /**
     * Get offset in x-direction of upper-left corner of shape measured in 1/1024 of column width
     *
     * @return int
     */
    public function getStartOffsetX()
    {
        return $this->_startOffsetX;
    }

    /**
     * Set offset in y-direction of upper-left corner of shape measured in 1/256 of row height
     *
     * @param int $startOffsetY
     */
    public function setStartOffsetY($startOffsetY = 0)
    {
        $this->_startOffsetY = $startOffsetY;
    }

    /**
     * Get offset in y-direction of upper-left corner of shape measured in 1/256 of row height
     *
     * @return int
     */
    public function getStartOffsetY()
    {
        return $this->_startOffsetY;
    }

    /**
     * Set cell coordinates of bottom-right corner of shape
     *
     * @param string $value
     */
    public function setEndCoordinates($value = 'A1')
    {
        $this->_endCoordinates = $value;
    }

    /**
     * Get cell coordinates of bottom-right corner of shape
     *
     * @return string
     */
    public function getEndCoordinates()
    {
        return $this->_endCoordinates;
    }

    /**
     * Set offset in x-direction of bottom-right corner of shape measured in 1/1024 of column width
     *
     * @param int $startOffsetX
     */
    public function setEndOffsetX($endOffsetX = 0)
    {
        $this->_endOffsetX = $endOffsetX;
    }

    /**
     * Get offset in x-direction of bottom-right corner of shape measured in 1/1024 of column width
     *
     * @return int
     */
    public function getEndOffsetX()
    {
        return $this->_endOffsetX;
    }

    /**
     * Set offset in y-direction of bottom-right corner of shape measured in 1/256 of row height
     *
     * @param int $endOffsetY
     */
    public function setEndOffsetY($endOffsetY = 0)
    {
        $this->_endOffsetY = $endOffsetY;
    }

    /**
     * Get offset in y-direction of bottom-right corner of shape measured in 1/256 of row height
     *
     * @return int
     */
    public function getEndOffsetY()
    {
        return $this->_endOffsetY;
    }

    /**
     * Get the nesting level of this spContainer. This is the number of spgrContainers between this spContainer and
     * the dgContainer. A value of 1 = immediately within first spgrContainer
     * Higher nesting level occurs if and only if spContainer is part of a shape group
     *
     * @return int Nesting level
     */
    public function getNestingLevel()
    {
        $nestingLevel = 0;

        $parent = $this->getParent();
        while ($parent instanceof PHPExcel_Shared_Escher_DgContainer_SpgrContainer) {
            ++$nestingLevel;
            $parent = $parent->getParent();
        }

        return $nestingLevel;
    }
}