123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421 |
- <?php
- namespace PhpOffice\PhpSpreadsheet\Style;
- use PhpOffice\PhpSpreadsheet\Exception as PhpSpreadsheetException;
- class Borders extends Supervisor
- {
- // Diagonal directions
- const DIAGONAL_NONE = 0;
- const DIAGONAL_UP = 1;
- const DIAGONAL_DOWN = 2;
- const DIAGONAL_BOTH = 3;
- /**
- * Left.
- *
- * @var Border
- */
- protected $left;
- /**
- * Right.
- *
- * @var Border
- */
- protected $right;
- /**
- * Top.
- *
- * @var Border
- */
- protected $top;
- /**
- * Bottom.
- *
- * @var Border
- */
- protected $bottom;
- /**
- * Diagonal.
- *
- * @var Border
- */
- protected $diagonal;
- /**
- * DiagonalDirection.
- *
- * @var int
- */
- protected $diagonalDirection;
- /**
- * All borders pseudo-border. Only applies to supervisor.
- *
- * @var Border
- */
- protected $allBorders;
- /**
- * Outline pseudo-border. Only applies to supervisor.
- *
- * @var Border
- */
- protected $outline;
- /**
- * Inside pseudo-border. Only applies to supervisor.
- *
- * @var Border
- */
- protected $inside;
- /**
- * Vertical pseudo-border. Only applies to supervisor.
- *
- * @var Border
- */
- protected $vertical;
- /**
- * Horizontal pseudo-border. Only applies to supervisor.
- *
- * @var Border
- */
- protected $horizontal;
- /**
- * Create a new Borders.
- *
- * @param bool $isSupervisor Flag indicating if this is a supervisor or not
- * Leave this value at default unless you understand exactly what
- * its ramifications are
- * @param bool $isConditional Flag indicating if this is a conditional style or not
- * Leave this value at default unless you understand exactly what
- * its ramifications are
- */
- public function __construct($isSupervisor = false, $isConditional = false)
- {
- // Supervisor?
- parent::__construct($isSupervisor);
- // Initialise values
- $this->left = new Border($isSupervisor, $isConditional);
- $this->right = new Border($isSupervisor, $isConditional);
- $this->top = new Border($isSupervisor, $isConditional);
- $this->bottom = new Border($isSupervisor, $isConditional);
- $this->diagonal = new Border($isSupervisor, $isConditional);
- $this->diagonalDirection = self::DIAGONAL_NONE;
- // Specially for supervisor
- if ($isSupervisor) {
- // Initialize pseudo-borders
- $this->allBorders = new Border(true);
- $this->outline = new Border(true);
- $this->inside = new Border(true);
- $this->vertical = new Border(true);
- $this->horizontal = new Border(true);
- // bind parent if we are a supervisor
- $this->left->bindParent($this, 'left');
- $this->right->bindParent($this, 'right');
- $this->top->bindParent($this, 'top');
- $this->bottom->bindParent($this, 'bottom');
- $this->diagonal->bindParent($this, 'diagonal');
- $this->allBorders->bindParent($this, 'allBorders');
- $this->outline->bindParent($this, 'outline');
- $this->inside->bindParent($this, 'inside');
- $this->vertical->bindParent($this, 'vertical');
- $this->horizontal->bindParent($this, 'horizontal');
- }
- }
- /**
- * Get the shared style component for the currently active cell in currently active sheet.
- * Only used for style supervisor.
- *
- * @return Borders
- */
- public function getSharedComponent()
- {
- return $this->parent->getSharedComponent()->getBorders();
- }
- /**
- * Build style array from subcomponents.
- *
- * @param array $array
- *
- * @return array
- */
- public function getStyleArray($array)
- {
- return ['borders' => $array];
- }
- /**
- * Apply styles from array.
- * <code>
- * $spreadsheet->getActiveSheet()->getStyle('B2')->getBorders()->applyFromArray(
- * array(
- * 'bottom' => array(
- * 'borderStyle' => Border::BORDER_DASHDOT,
- * 'color' => array(
- * 'rgb' => '808080'
- * )
- * ),
- * 'top' => array(
- * 'borderStyle' => Border::BORDER_DASHDOT,
- * 'color' => array(
- * 'rgb' => '808080'
- * )
- * )
- * )
- * );
- * </code>
- * <code>
- * $spreadsheet->getActiveSheet()->getStyle('B2')->getBorders()->applyFromArray(
- * array(
- * 'allBorders' => array(
- * 'borderStyle' => Border::BORDER_DASHDOT,
- * 'color' => array(
- * 'rgb' => '808080'
- * )
- * )
- * )
- * );
- * </code>.
- *
- * @param array $pStyles Array containing style information
- *
- * @throws PhpSpreadsheetException
- *
- * @return Borders
- */
- public function applyFromArray(array $pStyles)
- {
- if ($this->isSupervisor) {
- $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($this->getStyleArray($pStyles));
- } else {
- if (isset($pStyles['left'])) {
- $this->getLeft()->applyFromArray($pStyles['left']);
- }
- if (isset($pStyles['right'])) {
- $this->getRight()->applyFromArray($pStyles['right']);
- }
- if (isset($pStyles['top'])) {
- $this->getTop()->applyFromArray($pStyles['top']);
- }
- if (isset($pStyles['bottom'])) {
- $this->getBottom()->applyFromArray($pStyles['bottom']);
- }
- if (isset($pStyles['diagonal'])) {
- $this->getDiagonal()->applyFromArray($pStyles['diagonal']);
- }
- if (isset($pStyles['diagonalDirection'])) {
- $this->setDiagonalDirection($pStyles['diagonalDirection']);
- }
- if (isset($pStyles['allBorders'])) {
- $this->getLeft()->applyFromArray($pStyles['allBorders']);
- $this->getRight()->applyFromArray($pStyles['allBorders']);
- $this->getTop()->applyFromArray($pStyles['allBorders']);
- $this->getBottom()->applyFromArray($pStyles['allBorders']);
- }
- }
- return $this;
- }
- /**
- * Get Left.
- *
- * @return Border
- */
- public function getLeft()
- {
- return $this->left;
- }
- /**
- * Get Right.
- *
- * @return Border
- */
- public function getRight()
- {
- return $this->right;
- }
- /**
- * Get Top.
- *
- * @return Border
- */
- public function getTop()
- {
- return $this->top;
- }
- /**
- * Get Bottom.
- *
- * @return Border
- */
- public function getBottom()
- {
- return $this->bottom;
- }
- /**
- * Get Diagonal.
- *
- * @return Border
- */
- public function getDiagonal()
- {
- return $this->diagonal;
- }
- /**
- * Get AllBorders (pseudo-border). Only applies to supervisor.
- *
- * @throws PhpSpreadsheetException
- *
- * @return Border
- */
- public function getAllBorders()
- {
- if (!$this->isSupervisor) {
- throw new PhpSpreadsheetException('Can only get pseudo-border for supervisor.');
- }
- return $this->allBorders;
- }
- /**
- * Get Outline (pseudo-border). Only applies to supervisor.
- *
- * @throws PhpSpreadsheetException
- *
- * @return Border
- */
- public function getOutline()
- {
- if (!$this->isSupervisor) {
- throw new PhpSpreadsheetException('Can only get pseudo-border for supervisor.');
- }
- return $this->outline;
- }
- /**
- * Get Inside (pseudo-border). Only applies to supervisor.
- *
- * @throws PhpSpreadsheetException
- *
- * @return Border
- */
- public function getInside()
- {
- if (!$this->isSupervisor) {
- throw new PhpSpreadsheetException('Can only get pseudo-border for supervisor.');
- }
- return $this->inside;
- }
- /**
- * Get Vertical (pseudo-border). Only applies to supervisor.
- *
- * @throws PhpSpreadsheetException
- *
- * @return Border
- */
- public function getVertical()
- {
- if (!$this->isSupervisor) {
- throw new PhpSpreadsheetException('Can only get pseudo-border for supervisor.');
- }
- return $this->vertical;
- }
- /**
- * Get Horizontal (pseudo-border). Only applies to supervisor.
- *
- * @throws PhpSpreadsheetException
- *
- * @return Border
- */
- public function getHorizontal()
- {
- if (!$this->isSupervisor) {
- throw new PhpSpreadsheetException('Can only get pseudo-border for supervisor.');
- }
- return $this->horizontal;
- }
- /**
- * Get DiagonalDirection.
- *
- * @return int
- */
- public function getDiagonalDirection()
- {
- if ($this->isSupervisor) {
- return $this->getSharedComponent()->getDiagonalDirection();
- }
- return $this->diagonalDirection;
- }
- /**
- * Set DiagonalDirection.
- *
- * @param int $pValue see self::DIAGONAL_*
- *
- * @return Borders
- */
- public function setDiagonalDirection($pValue)
- {
- if ($pValue == '') {
- $pValue = self::DIAGONAL_NONE;
- }
- if ($this->isSupervisor) {
- $styleArray = $this->getStyleArray(['diagonalDirection' => $pValue]);
- $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
- } else {
- $this->diagonalDirection = $pValue;
- }
- return $this;
- }
- /**
- * Get hash code.
- *
- * @return string Hash code
- */
- public function getHashCode()
- {
- if ($this->isSupervisor) {
- return $this->getSharedComponent()->getHashcode();
- }
- return md5(
- $this->getLeft()->getHashCode() .
- $this->getRight()->getHashCode() .
- $this->getTop()->getHashCode() .
- $this->getBottom()->getHashCode() .
- $this->getDiagonal()->getHashCode() .
- $this->getDiagonalDirection() .
- __CLASS__
- );
- }
- }
|