Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.10.x will end 8 November 2021 (12 months).
  • Bug fixes for security issues in 3.10.x will end 9 May 2022 (18 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.
<?php

namespace PhpOffice\PhpSpreadsheet\Style;

< use PhpOffice\PhpSpreadsheet\Exception as PhpSpreadsheetException; <
class Fill extends Supervisor { // Fill types const FILL_NONE = 'none'; const FILL_SOLID = 'solid'; const FILL_GRADIENT_LINEAR = 'linear'; const FILL_GRADIENT_PATH = 'path'; const FILL_PATTERN_DARKDOWN = 'darkDown'; const FILL_PATTERN_DARKGRAY = 'darkGray'; const FILL_PATTERN_DARKGRID = 'darkGrid'; const FILL_PATTERN_DARKHORIZONTAL = 'darkHorizontal'; const FILL_PATTERN_DARKTRELLIS = 'darkTrellis'; const FILL_PATTERN_DARKUP = 'darkUp'; const FILL_PATTERN_DARKVERTICAL = 'darkVertical'; const FILL_PATTERN_GRAY0625 = 'gray0625'; const FILL_PATTERN_GRAY125 = 'gray125'; const FILL_PATTERN_LIGHTDOWN = 'lightDown'; const FILL_PATTERN_LIGHTGRAY = 'lightGray'; const FILL_PATTERN_LIGHTGRID = 'lightGrid'; const FILL_PATTERN_LIGHTHORIZONTAL = 'lightHorizontal'; const FILL_PATTERN_LIGHTTRELLIS = 'lightTrellis'; const FILL_PATTERN_LIGHTUP = 'lightUp'; const FILL_PATTERN_LIGHTVERTICAL = 'lightVertical'; const FILL_PATTERN_MEDIUMGRAY = 'mediumGray'; /**
< * @var int
> * @var null|int
*/ public $startcolorIndex; /**
< * @var int
> * @var null|int
*/ public $endcolorIndex; /** * Fill type. *
< * @var string
> * @var null|string
*/ protected $fillType = self::FILL_NONE; /** * Rotation. * * @var float */
< protected $rotation = 0;
> protected $rotation = 0.0;
/** * Start color. * * @var Color */ protected $startColor; /** * End color. * * @var Color */ protected $endColor;
> /** @var bool */ /** > private $colorChanged = false; * Create a new Fill. >
* * @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 if ($isConditional) { $this->fillType = null; } $this->startColor = new Color(Color::COLOR_WHITE, $isSupervisor, $isConditional); $this->endColor = new Color(Color::COLOR_BLACK, $isSupervisor, $isConditional); // bind parent if we are a supervisor if ($isSupervisor) { $this->startColor->bindParent($this, 'startColor'); $this->endColor->bindParent($this, 'endColor'); } } /** * Get the shared style component for the currently active cell in currently active sheet. * Only used for style supervisor. * * @return Fill */ public function getSharedComponent() {
< return $this->parent->getSharedComponent()->getFill();
> /** @var Style */ > $parent = $this->parent; > > return $parent->getSharedComponent()->getFill();
} /** * Build style array from subcomponents. * * @param array $array * * @return array */ public function getStyleArray($array) { return ['fill' => $array]; } /** * Apply styles from array. * * <code> * $spreadsheet->getActiveSheet()->getStyle('B2')->getFill()->applyFromArray( * [ * 'fillType' => Fill::FILL_GRADIENT_LINEAR,
< * 'rotation' => 0,
> * 'rotation' => 0.0,
* 'startColor' => [ * 'rgb' => '000000' * ], * 'endColor' => [ * 'argb' => 'FFFFFFFF' * ] * ] * ); * </code> *
< * @param array $pStyles Array containing style information < * < * @throws PhpSpreadsheetException
> * @param array $styleArray Array containing style information
*
< * @return Fill
> * @return $this
*/
< public function applyFromArray(array $pStyles)
> public function applyFromArray(array $styleArray)
{ if ($this->isSupervisor) {
< $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($this->getStyleArray($pStyles));
> $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($this->getStyleArray($styleArray));
} else {
< if (isset($pStyles['fillType'])) { < $this->setFillType($pStyles['fillType']);
> if (isset($styleArray['fillType'])) { > $this->setFillType($styleArray['fillType']);
}
< if (isset($pStyles['rotation'])) { < $this->setRotation($pStyles['rotation']);
> if (isset($styleArray['rotation'])) { > $this->setRotation($styleArray['rotation']);
}
< if (isset($pStyles['startColor'])) { < $this->getStartColor()->applyFromArray($pStyles['startColor']);
> if (isset($styleArray['startColor'])) { > $this->getStartColor()->applyFromArray($styleArray['startColor']);
}
< if (isset($pStyles['endColor'])) { < $this->getEndColor()->applyFromArray($pStyles['endColor']);
> if (isset($styleArray['endColor'])) { > $this->getEndColor()->applyFromArray($styleArray['endColor']);
}
< if (isset($pStyles['color'])) { < $this->getStartColor()->applyFromArray($pStyles['color']); < $this->getEndColor()->applyFromArray($pStyles['color']);
> if (isset($styleArray['color'])) { > $this->getStartColor()->applyFromArray($styleArray['color']); > $this->getEndColor()->applyFromArray($styleArray['color']);
} } return $this; } /** * Get Fill Type. *
< * @return string
> * @return null|string
*/ public function getFillType() { if ($this->isSupervisor) { return $this->getSharedComponent()->getFillType(); } return $this->fillType; } /** * Set Fill Type. *
< * @param string $pValue Fill type, see self::FILL_*
> * @param string $fillType Fill type, see self::FILL_*
*
< * @return Fill
> * @return $this
*/
< public function setFillType($pValue)
> public function setFillType($fillType)
{ if ($this->isSupervisor) {
< $styleArray = $this->getStyleArray(['fillType' => $pValue]);
> $styleArray = $this->getStyleArray(['fillType' => $fillType]);
$this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray); } else {
< $this->fillType = $pValue;
> $this->fillType = $fillType;
} return $this; } /** * Get Rotation. * * @return float */ public function getRotation() { if ($this->isSupervisor) { return $this->getSharedComponent()->getRotation(); } return $this->rotation; } /** * Set Rotation. *
< * @param float $pValue
> * @param float $angleInDegrees
*
< * @return Fill
> * @return $this
*/
< public function setRotation($pValue)
> public function setRotation($angleInDegrees)
{ if ($this->isSupervisor) {
< $styleArray = $this->getStyleArray(['rotation' => $pValue]);
> $styleArray = $this->getStyleArray(['rotation' => $angleInDegrees]);
$this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray); } else {
< $this->rotation = $pValue;
> $this->rotation = $angleInDegrees;
} return $this; } /** * Get Start Color. * * @return Color */ public function getStartColor() { return $this->startColor; } /** * Set Start Color. *
< * @param Color $pValue < * < * @throws PhpSpreadsheetException < * < * @return Fill
> * @return $this
*/
< public function setStartColor(Color $pValue)
> public function setStartColor(Color $color)
{
> $this->colorChanged = true;
// make sure parameter is a real color and not a supervisor
< $color = $pValue->getIsSupervisor() ? $pValue->getSharedComponent() : $pValue;
> $color = $color->getIsSupervisor() ? $color->getSharedComponent() : $color;
if ($this->isSupervisor) { $styleArray = $this->getStartColor()->getStyleArray(['argb' => $color->getARGB()]); $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray); } else { $this->startColor = $color; } return $this; } /** * Get End Color. * * @return Color */ public function getEndColor() { return $this->endColor; } /** * Set End Color. *
< * @param Color $pValue < * < * @throws PhpSpreadsheetException < * < * @return Fill
> * @return $this
*/
< public function setEndColor(Color $pValue)
> public function setEndColor(Color $color)
{
> $this->colorChanged = true;
// make sure parameter is a real color and not a supervisor
< $color = $pValue->getIsSupervisor() ? $pValue->getSharedComponent() : $pValue;
> $color = $color->getIsSupervisor() ? $color->getSharedComponent() : $color;
if ($this->isSupervisor) { $styleArray = $this->getEndColor()->getStyleArray(['argb' => $color->getARGB()]); $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray); } else { $this->endColor = $color; } return $this; }
> public function getColorsChanged(): bool /** > { * Get hash code. > if ($this->isSupervisor) { * > $changed = $this->getSharedComponent()->colorChanged; * @return string Hash code > } else { */ > $changed = $this->colorChanged; public function getHashCode() > } { > if ($this->isSupervisor) { > return $changed || $this->startColor->getHasChanged() || $this->endColor->getHasChanged(); return $this->getSharedComponent()->getHashCode(); > } } >
// Note that we don't care about colours for fill type NONE, but could have duplicate NONEs with // different hashes if we don't explicitly prevent this return md5( $this->getFillType() . $this->getRotation() . ($this->getFillType() !== self::FILL_NONE ? $this->getStartColor()->getHashCode() : '') . ($this->getFillType() !== self::FILL_NONE ? $this->getEndColor()->getHashCode() : '') .
> ((string) $this->getColorsChanged()) .
__CLASS__ );
> } } > } > protected function exportArray1(): array > { > $exportedArray = []; > $this->exportArray2($exportedArray, 'fillType', $this->getFillType()); > $this->exportArray2($exportedArray, 'rotation', $this->getRotation()); > if ($this->getColorsChanged()) { > $this->exportArray2($exportedArray, 'endColor', $this->getEndColor()); > $this->exportArray2($exportedArray, 'startColor', $this->getStartColor()); > } > > return $exportedArray;