Protection.php

Go to the documentation of this file.

<?php
class PHPExcel_Style_Protection extends PHPExcel_Style_Supervisor implements PHPExcel_IComparable
{
        const PROTECTION_INHERIT                = 'inherit';
        const PROTECTION_PROTECTED              = 'protected';
        const PROTECTION_UNPROTECTED    = 'unprotected';

        protected $_locked;

        protected $_hidden;

    public function __construct($isSupervisor = FALSE, $isConditional = FALSE)
    {
        // Supervisor?
                parent::__construct($isSupervisor);

        // Initialise values
                if (!$isConditional) {
                $this->_locked                  = self::PROTECTION_INHERIT;
                $this->_hidden                  = self::PROTECTION_INHERIT;
                }
    }

        public function getSharedComponent()
        {
                return $this->_parent->getSharedComponent()->getProtection();
        }

        public function getStyleArray($array)
        {
                return array('protection' => $array);
        }

        public function applyFromArray($pStyles = NULL) {
                if (is_array($pStyles)) {
                        if ($this->_isSupervisor) {
                                $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($this->getStyleArray($pStyles));
                        } else {
                                if (isset($pStyles['locked'])) {
                                        $this->setLocked($pStyles['locked']);
                                }
                                if (isset($pStyles['hidden'])) {
                                        $this->setHidden($pStyles['hidden']);
                                }
                        }
                } else {
                        throw new PHPExcel_Exception("Invalid style array passed.");
                }
                return $this;
        }

    public function getLocked() {
                if ($this->_isSupervisor) {
                        return $this->getSharedComponent()->getLocked();
                }
        return $this->_locked;
    }

    public function setLocked($pValue = self::PROTECTION_INHERIT) {
                if ($this->_isSupervisor) {
                        $styleArray = $this->getStyleArray(array('locked' => $pValue));
                        $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
                } else {
                        $this->_locked = $pValue;
                }
                return $this;
    }

    public function getHidden() {
                if ($this->_isSupervisor) {
                        return $this->getSharedComponent()->getHidden();
                }
        return $this->_hidden;
    }

    public function setHidden($pValue = self::PROTECTION_INHERIT) {
                if ($this->_isSupervisor) {
                        $styleArray = $this->getStyleArray(array('hidden' => $pValue));
                        $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
                } else {
                        $this->_hidden = $pValue;
                }
                return $this;
    }

        public function getHashCode() {
                if ($this->_isSupervisor) {
                        return $this->getSharedComponent()->getHashCode();
                }
        return md5(
                  $this->_locked
                . $this->_hidden
                . __CLASS__
        );
    }

}