Back to Devexpress

CellRange.RowHeight Property

officefileapi-devexpress-dot-spreadsheet-dot-cellrange-e7ff1f45.md

latest7.9 KB
Original Source

CellRange.RowHeight Property

Gets or sets the height of rows that contain this cell range.

Namespace : DevExpress.Spreadsheet

Assembly : DevExpress.Spreadsheet.v25.2.Core.dll

NuGet Package : DevExpress.Spreadsheet.Core

Declaration

csharp
double RowHeight { get; set; }
vb
Property RowHeight As Double

Property Value

TypeDescription
Double

The row height in measurement units defined by the Workbook.Unit property.

|

Exceptions

TypeDescription
ArgumentException

Occurs if the row height exceeds 409 points.

|

Remarks

If rows that contain the cell range have different heights, the RowHeight property returns the height of the topmost row.

Example

This example demonstrates how to control the row height in a worksheet.

Set Height for Individual Rows

Use the Row.Height or CellRange.RowHeight property to set the row height in the workbook’s measurement units.

Note

If the row height is set to 0, the row is hidden. You can also use the Row.Visible property to hide a row or display the hidden row again.

AutoFit Row Height

To automatically change the row height to fit the contents, use the row’s Row.AutoFit method. To quickly autofit several rows in a worksheet, use the RowCollection.AutoFit method.

Use the SpreadsheetCellOptions.AutoFitMergedCellRowHeight property to enable the AutoFit functionality for rows that have cells merged across.

Match the Height of Two Rows

To match one row height to another, make their Row.Height property values equal.

Set the Default Row Height

To set the default height for worksheet rows, use the Worksheet.DefaultRowHeight property. This property does not affect rows with an explicitly specified height.

Set the Height for All Rows in a Worksheet

To change the height of all rows in a worksheet, use the CellRange.RowHeight property of the Column object corresponding to any column in a worksheet. This sets the height of all rows to the same value, overriding all previously applied row height settings.

View Example

csharp
// Set the height of the 3rd row to 50 points
workbook.Unit = DevExpress.Office.DocumentUnit.Point;
worksheet.Rows[2].Height = 50;

// Set the height of the row that contains the "C5" cell to 2 inches.
workbook.Unit = DevExpress.Office.DocumentUnit.Inch;
worksheet.Cells["C5"].RowHeight = 2;

// Set the height of the 7th row to the height of the 3rd row.
worksheet.Rows["7"].Height = worksheet.Rows["3"].Height;

// Set the default row height to 30 points.
workbook.Unit = DevExpress.Office.DocumentUnit.Point;
worksheet.DefaultRowHeight = 30;
vb
' Set the height of the 3rd row to 50 points
workbook.Unit = DevExpress.Office.DocumentUnit.Point
worksheet.Rows(2).Height = 50

' Set the height of the row that contains the "C5" cell to 2 inches.
workbook.Unit = DevExpress.Office.DocumentUnit.Inch
worksheet.Cells("C5").RowHeight = 2

' Set the height of the 7th row to the height of the 3rd row.
worksheet.Rows("7").Height = worksheet.Rows("3").Height

' Set the default row height to 30 points.
workbook.Unit = DevExpress.Office.DocumentUnit.Point
worksheet.DefaultRowHeight = 30

The following code snippets (auto-collected from DevExpress Examples) contain references to the RowHeight property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

winforms-spreadsheetcontrol-api-part1/CS/SpreadsheetControl/SpreadsheetActions/FormattingActions.cs#L418

csharp
workbook.Unit = DevExpress.Office.DocumentUnit.Inch;
range.RowHeight = 1;

wpf-spreadsheetcontrol-api-part-1/CS/SpreadsheetControl_WPF_API/SpreadsheetActions/FormattingActions.cs#L387

csharp
workbook.Unit = DevExpress.Office.DocumentUnit.Inch;
range.RowHeight = 1;

spreadsheet-document-api-examples-part1/CS/SpreadsheetExamples/SpreadsheetActions/FormattingActions.cs#L272

csharp
range.ColumnWidthInCharacters = 30;
range.RowHeight = 200;

winforms-spreadsheetcontrol-api-part1/VB/SpreadsheetControl/SpreadsheetActions/FormattingActions.vb#L405

vb
workbook.Unit = DevExpress.Office.DocumentUnit.Inch
range.RowHeight = 1

wpf-spreadsheetcontrol-api-part-1/VB/SpreadsheetControl_WPF_API/SpreadsheetActions/FormattingActions.vb#L373

vb
workbook.Unit = DevExpress.Office.DocumentUnit.Inch
range.RowHeight = 1

spreadsheet-document-api-examples-part1/VB/SpreadsheetExamples/SpreadsheetActions/FormattingActions.vb#L222

vb
range.ColumnWidthInCharacters = 30
            range.RowHeight = 200
#Region "#AlignCellContents"

See Also

Height

DefaultRowHeight

ColumnWidth

ColumnWidthInCharacters

CellRange Interface

CellRange Members

DevExpress.Spreadsheet Namespace