# tablepress/3.4/libraries/vendor/PhpSpreadsheet/Worksheet/ColumnDimension.php

TablePress – Tables in WordPress made easy, version 3.4. 139 lines.

- Page: https://pluginprobe.com/plugins/tablepress/3.4/code/libraries/vendor/PhpSpreadsheet/Worksheet/ColumnDimension.php
- Raw: https://pluginprobe.com/plugins/tablepress/3.4/raw/libraries/vendor/PhpSpreadsheet/Worksheet/ColumnDimension.php
- Modified: 2025-08-28T14:52:54+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/tablepress/3.4/code/libraries/vendor/PhpSpreadsheet/Worksheet/ColumnDimension.php#L10-L20`.

```php
<?php

namespace TablePress\PhpOffice\PhpSpreadsheet\Worksheet;

use TablePress\PhpOffice\PhpSpreadsheet\Cell\Coordinate;
use TablePress\PhpOffice\PhpSpreadsheet\Helper\Dimension as CssDimension;

class ColumnDimension extends Dimension
{
	public const EXCEL_MAX_WIDTH = 255.0;

	/**
	 * Column index.
	 */
	private ?string $columnIndex;

	/**
	 * Column width.
	 *
	 * When this is set to a negative value, the column width should be ignored by IWriter
	 */
	private float $width = -1;

	/**
	 * Auto size?
	 */
	private bool $autoSize = false;

	/**
	 * Create a new ColumnDimension.
	 *
	 * @param ?string $index Character column index
	 */
	public function __construct(?string $index = 'A')
	{
		// Initialise values
		$this->columnIndex = $index;

		// set dimension as unformatted by default
		parent::__construct(0);
	}

	/**
	 * Get column index as string eg: 'A'.
	 */
	public function getColumnIndex(): ?string
	{
		return $this->columnIndex;
	}

	/**
	 * Set column index as string eg: 'A'.
	 */
	public function setColumnIndex(string $index): self
	{
		$this->columnIndex = $index;

		return $this;
	}

	/**
	 * Get column index as numeric.
	 */
	public function getColumnNumeric(): int
	{
		return Coordinate::columnIndexFromString($this->columnIndex ?? '');
	}

	/**
	 * Set column index as numeric.
	 */
	public function setColumnNumeric(int $index): self
	{
		$this->columnIndex = Coordinate::stringFromColumnIndex($index);

		return $this;
	}

	/**
	 * Get Width.
	 *
	 * Each unit of column width is equal to the width of one character in the default font size. A value of -1
	 *      tells Excel to display this column in its default width.
	 * By default, this will be the return value; but this method also accepts an optional unit of measure argument
	 *    and will convert the returned value to the specified UoM..
	 */
	public function getWidth(?string $unitOfMeasure = null): float
	{
		return ($unitOfMeasure === null || $this->width < 0)
			? $this->width
			: (new CssDimension((string) $this->width))->toUnit($unitOfMeasure);
	}

	public function getWidthForOutput(bool $restrictMax): float
	{
		return ($restrictMax && $this->width > self::EXCEL_MAX_WIDTH) ? self::EXCEL_MAX_WIDTH : $this->width;
	}

	/**
	 * Set Width.
	 *
	 * Each unit of column width is equal to the width of one character in the default font size. A value of -1
	 *      tells Excel to display this column in its default width.
	 * By default, this will be the unit of measure for the passed value; but this method also accepts an
	 *    optional unit of measure argument, and will convert the value from the specified UoM using an
	 *    approximation method.
	 *
	 * @return $this
	 */
	public function setWidth(float $width, ?string $unitOfMeasure = null)
	{
		$this->width = ($unitOfMeasure === null || $width < 0)
			? $width
			: (new CssDimension("{$width}{$unitOfMeasure}"))->width();

		return $this;
	}

	/**
	 * Get Auto Size.
	 */
	public function getAutoSize(): bool
	{
		return $this->autoSize;
	}

	/**
	 * Set Auto Size.
	 *
	 * @return $this
	 */
	public function setAutoSize(bool $autosizeEnabled)
	{
		$this->autoSize = $autosizeEnabled;

		return $this;
	}
}

```