123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465 |
- <?php
- namespace PhpOffice\PhpSpreadsheet\Style;
- use PhpOffice\PhpSpreadsheet\Exception as PhpSpreadsheetException;
- class Alignment extends Supervisor
- {
- // Horizontal alignment styles
- const HORIZONTAL_GENERAL = 'general';
- const HORIZONTAL_LEFT = 'left';
- const HORIZONTAL_RIGHT = 'right';
- const HORIZONTAL_CENTER = 'center';
- const HORIZONTAL_CENTER_CONTINUOUS = 'centerContinuous';
- const HORIZONTAL_JUSTIFY = 'justify';
- const HORIZONTAL_FILL = 'fill';
- const HORIZONTAL_DISTRIBUTED = 'distributed'; // Excel2007 only
- // Vertical alignment styles
- const VERTICAL_BOTTOM = 'bottom';
- const VERTICAL_TOP = 'top';
- const VERTICAL_CENTER = 'center';
- const VERTICAL_JUSTIFY = 'justify';
- const VERTICAL_DISTRIBUTED = 'distributed'; // Excel2007 only
- // Read order
- const READORDER_CONTEXT = 0;
- const READORDER_LTR = 1;
- const READORDER_RTL = 2;
- /**
- * Horizontal alignment.
- *
- * @var string
- */
- protected $horizontal = self::HORIZONTAL_GENERAL;
- /**
- * Vertical alignment.
- *
- * @var string
- */
- protected $vertical = self::VERTICAL_BOTTOM;
- /**
- * Text rotation.
- *
- * @var int
- */
- protected $textRotation = 0;
- /**
- * Wrap text.
- *
- * @var bool
- */
- protected $wrapText = false;
- /**
- * Shrink to fit.
- *
- * @var bool
- */
- protected $shrinkToFit = false;
- /**
- * Indent - only possible with horizontal alignment left and right.
- *
- * @var int
- */
- protected $indent = 0;
- /**
- * Read order.
- *
- * @var int
- */
- protected $readOrder = 0;
- /**
- * Create a new Alignment.
- *
- * @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);
- if ($isConditional) {
- $this->horizontal = null;
- $this->vertical = null;
- $this->textRotation = null;
- }
- }
- /**
- * Get the shared style component for the currently active cell in currently active sheet.
- * Only used for style supervisor.
- *
- * @return Alignment
- */
- public function getSharedComponent()
- {
- return $this->parent->getSharedComponent()->getAlignment();
- }
- /**
- * Build style array from subcomponents.
- *
- * @param array $array
- *
- * @return array
- */
- public function getStyleArray($array)
- {
- return ['alignment' => $array];
- }
- /**
- * Apply styles from array.
- * <code>
- * $spreadsheet->getActiveSheet()->getStyle('B2')->getAlignment()->applyFromArray(
- * array(
- * 'horizontal' => \PhpOffice\PhpSpreadsheet\Style\Alignment::HORIZONTAL_CENTER,
- * 'vertical' => \PhpOffice\PhpSpreadsheet\Style\Alignment::VERTICAL_CENTER,
- * 'textRotation' => 0,
- * 'wrapText' => TRUE
- * )
- * );
- * </code>.
- *
- * @param array $pStyles Array containing style information
- *
- * @throws PhpSpreadsheetException
- *
- * @return Alignment
- */
- public function applyFromArray(array $pStyles)
- {
- if ($this->isSupervisor) {
- $this->getActiveSheet()->getStyle($this->getSelectedCells())
- ->applyFromArray($this->getStyleArray($pStyles));
- } else {
- if (isset($pStyles['horizontal'])) {
- $this->setHorizontal($pStyles['horizontal']);
- }
- if (isset($pStyles['vertical'])) {
- $this->setVertical($pStyles['vertical']);
- }
- if (isset($pStyles['textRotation'])) {
- $this->setTextRotation($pStyles['textRotation']);
- }
- if (isset($pStyles['wrapText'])) {
- $this->setWrapText($pStyles['wrapText']);
- }
- if (isset($pStyles['shrinkToFit'])) {
- $this->setShrinkToFit($pStyles['shrinkToFit']);
- }
- if (isset($pStyles['indent'])) {
- $this->setIndent($pStyles['indent']);
- }
- if (isset($pStyles['readOrder'])) {
- $this->setReadOrder($pStyles['readOrder']);
- }
- }
- return $this;
- }
- /**
- * Get Horizontal.
- *
- * @return string
- */
- public function getHorizontal()
- {
- if ($this->isSupervisor) {
- return $this->getSharedComponent()->getHorizontal();
- }
- return $this->horizontal;
- }
- /**
- * Set Horizontal.
- *
- * @param string $pValue see self::HORIZONTAL_*
- *
- * @return Alignment
- */
- public function setHorizontal($pValue)
- {
- if ($pValue == '') {
- $pValue = self::HORIZONTAL_GENERAL;
- }
- if ($this->isSupervisor) {
- $styleArray = $this->getStyleArray(['horizontal' => $pValue]);
- $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
- } else {
- $this->horizontal = $pValue;
- }
- return $this;
- }
- /**
- * Get Vertical.
- *
- * @return string
- */
- public function getVertical()
- {
- if ($this->isSupervisor) {
- return $this->getSharedComponent()->getVertical();
- }
- return $this->vertical;
- }
- /**
- * Set Vertical.
- *
- * @param string $pValue see self::VERTICAL_*
- *
- * @return Alignment
- */
- public function setVertical($pValue)
- {
- if ($pValue == '') {
- $pValue = self::VERTICAL_BOTTOM;
- }
- if ($this->isSupervisor) {
- $styleArray = $this->getStyleArray(['vertical' => $pValue]);
- $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
- } else {
- $this->vertical = $pValue;
- }
- return $this;
- }
- /**
- * Get TextRotation.
- *
- * @return int
- */
- public function getTextRotation()
- {
- if ($this->isSupervisor) {
- return $this->getSharedComponent()->getTextRotation();
- }
- return $this->textRotation;
- }
- /**
- * Set TextRotation.
- *
- * @param int $pValue
- *
- * @throws PhpSpreadsheetException
- *
- * @return Alignment
- */
- public function setTextRotation($pValue)
- {
- // Excel2007 value 255 => PhpSpreadsheet value -165
- if ($pValue == 255) {
- $pValue = -165;
- }
- // Set rotation
- if (($pValue >= -90 && $pValue <= 90) || $pValue == -165) {
- if ($this->isSupervisor) {
- $styleArray = $this->getStyleArray(['textRotation' => $pValue]);
- $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
- } else {
- $this->textRotation = $pValue;
- }
- } else {
- throw new PhpSpreadsheetException('Text rotation should be a value between -90 and 90.');
- }
- return $this;
- }
- /**
- * Get Wrap Text.
- *
- * @return bool
- */
- public function getWrapText()
- {
- if ($this->isSupervisor) {
- return $this->getSharedComponent()->getWrapText();
- }
- return $this->wrapText;
- }
- /**
- * Set Wrap Text.
- *
- * @param bool $pValue
- *
- * @return Alignment
- */
- public function setWrapText($pValue)
- {
- if ($pValue == '') {
- $pValue = false;
- }
- if ($this->isSupervisor) {
- $styleArray = $this->getStyleArray(['wrapText' => $pValue]);
- $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
- } else {
- $this->wrapText = $pValue;
- }
- return $this;
- }
- /**
- * Get Shrink to fit.
- *
- * @return bool
- */
- public function getShrinkToFit()
- {
- if ($this->isSupervisor) {
- return $this->getSharedComponent()->getShrinkToFit();
- }
- return $this->shrinkToFit;
- }
- /**
- * Set Shrink to fit.
- *
- * @param bool $pValue
- *
- * @return Alignment
- */
- public function setShrinkToFit($pValue)
- {
- if ($pValue == '') {
- $pValue = false;
- }
- if ($this->isSupervisor) {
- $styleArray = $this->getStyleArray(['shrinkToFit' => $pValue]);
- $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
- } else {
- $this->shrinkToFit = $pValue;
- }
- return $this;
- }
- /**
- * Get indent.
- *
- * @return int
- */
- public function getIndent()
- {
- if ($this->isSupervisor) {
- return $this->getSharedComponent()->getIndent();
- }
- return $this->indent;
- }
- /**
- * Set indent.
- *
- * @param int $pValue
- *
- * @return Alignment
- */
- public function setIndent($pValue)
- {
- if ($pValue > 0) {
- if ($this->getHorizontal() != self::HORIZONTAL_GENERAL &&
- $this->getHorizontal() != self::HORIZONTAL_LEFT &&
- $this->getHorizontal() != self::HORIZONTAL_RIGHT) {
- $pValue = 0; // indent not supported
- }
- }
- if ($this->isSupervisor) {
- $styleArray = $this->getStyleArray(['indent' => $pValue]);
- $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
- } else {
- $this->indent = $pValue;
- }
- return $this;
- }
- /**
- * Get read order.
- *
- * @return int
- */
- public function getReadOrder()
- {
- if ($this->isSupervisor) {
- return $this->getSharedComponent()->getReadOrder();
- }
- return $this->readOrder;
- }
- /**
- * Set read order.
- *
- * @param int $pValue
- *
- * @return Alignment
- */
- public function setReadOrder($pValue)
- {
- if ($pValue < 0 || $pValue > 2) {
- $pValue = 0;
- }
- if ($this->isSupervisor) {
- $styleArray = $this->getStyleArray(['readOrder' => $pValue]);
- $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
- } else {
- $this->readOrder = $pValue;
- }
- return $this;
- }
- /**
- * Get hash code.
- *
- * @return string Hash code
- */
- public function getHashCode()
- {
- if ($this->isSupervisor) {
- return $this->getSharedComponent()->getHashCode();
- }
- return md5(
- $this->horizontal .
- $this->vertical .
- $this->textRotation .
- ($this->wrapText ? 't' : 'f') .
- ($this->shrinkToFit ? 't' : 'f') .
- $this->indent .
- $this->readOrder .
- __CLASS__
- );
- }
- }
|