Improved documentation for setting row height/column width

Author: MarkBaker

docs/topics/recipes.md

@@ -1167,13 +1167,15 @@ that you are setting is measured in.
 Valid units are `pt` (points), `px` (pixels), `pc` (pica), `in` (inches),
 `cm` (centimeters) and `mm` (millimeters).
 
+Setting the column width to `-1` tells MS Excel to display the column using its default width.  
+
 ```php
 $spreadsheet->getActiveSheet()->getColumnDimension('D')->setWidth(120, 'pt');
 ```
 
 If you want PhpSpreadsheet to perform an automatic width calculation,
-use the following code. PhpSpreadsheet will approximate the column with
-to the width of the widest column value.
+use the following code. PhpSpreadsheet will approximate the column width
+to the width of the widest value displayed in that column.
 
 ```php
 $spreadsheet->getActiveSheet()->getColumnDimension('B')->setAutoSize(true);
@@ -1266,6 +1268,18 @@ Valid units are `pt` (points), `px` (pixels), `pc` (pica), `in` (inches),
 $spreadsheet->getActiveSheet()->getRowDimension('10')->setRowHeight(100, 'pt');
 ```
 
+Setting the row height to `-1` tells MS Excel to display the column using its default height, which is based on the character font size.
+
+If you have wrapped text in a cell, then the `-1` default will only set the row height to display a single line of that wrapped text.
+If you need to calculate the actual height for the row, then count the lines that should be displayed (count the `\n` and add 1); then adjust for the font.
+The adjustment for Calibri 11 is approximately 14.5; for Calibri 12 15.9, etc.
+```php
+$spreadsheet->getActiveSheet()->getRowDimension(1)->setRowHeight(
+    14.5 * (substr_count($sheet->getCell('A1')->getValue(), "\n") + 1)
+);
+```
+
+
 ## Show/hide a row
 
 To set a worksheet''s row visibility, you can use the following code.

src/PhpSpreadsheet/Worksheet/ColumnDimension.php

@@ -83,9 +83,10 @@ public function setColumnNumeric(int $index): self
     /**
      * Get Width.
      *
-     * Each unit of column width is equal to the width of one character in the default font size.
-     * By default, this will be the return value; but this method also accepts a unit of measure argument and will
-     *     return the value converted to the specified UoM using an approximation method.
+     * 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
     {
@@ -97,9 +98,11 @@ public function getWidth(?string $unitOfMeasure = null): float
     /**
      * Set Width.
      *
-     * Each unit of column width is equal to the width of one character in the default font size.
-     * By default, this will be the unit of measure for the passed value; but this method accepts a unit of measure
-     *    argument, and will convert the value from the specified UoM using an approximation method.
+     * 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
      */

src/PhpSpreadsheet/Worksheet/RowDimension.php

@@ -65,8 +65,9 @@ public function setRowIndex(int $index)
 
     /**
      * Get Row Height.
-     * By default, this will be in points; but this method accepts a unit of measure
-     *    argument, and will convert the value to the specified UoM.
+     * By default, this will be in points; but this method also accepts an optional unit of measure
+     *    argument, and will convert the value from points to the specified UoM.
+     *    A value of -1 tells Excel to display this column in its default height.
      *
      * @return float
      */
@@ -80,8 +81,8 @@ public function getRowHeight(?string $unitOfMeasure = null)
     /**
      * Set Row Height.
      *
-     * @param float $height in points
-     * By default, this will be the passed argument value; but this method accepts a unit of measure
+     * @param float $height in points. A value of -1 tells Excel to display this column in its default height.
+     * By default, this will be the passed argument value; but this method also accepts an optional unit of measure
      *    argument, and will convert the passed argument value to points from the specified UoM
      *
      * @return $this