Format Rows and Columns

When working with spreadsheets and adding data to rows or columns, you might need to change the height of rows or width of columns. Sometimes, applying formatting on rows or columns means that the current height or width needs to change to show the data. Normally, users adjust row heights and column widths in a WYSIWYG environment using Microsoft Excel. But, with Aspose.Cells developers can perform these operations at runtime.

Working with Rows

How to Adjust Row Height

Aspose.Cells provides a class, Workbook, that represents a Microsoft Excel file. The Workbook class contains a WorksheetCollection that allows access to each worksheet in the Excel file. A worksheet is represented by the Worksheet class. The Worksheet class provides a Cells collection that represents all cells in the worksheet.

The Cells collection provides several methods to manage rows or columns in a worksheet. Some of these are discussed below in more detail.

How to Set the Height of a Row

It is possible to set the height of a single row by calling the Cells collection’s SetRowHeight method. The SetRowHeight method takes the following parameters as follows:

• Row index, the index of the row that you’re changing the height of.
• Row height, the row height to apply on the row.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Creating a file stream containing the Excel file to be opened
FileStream fstream = new FileStream(dataDir + "book1.xls", FileMode.Open);

// Instantiating a Workbook object
// Opening the Excel file through the file stream
Workbook workbook = new Workbook(fstream);

// Accessing the first worksheet in the Excel file
Worksheet worksheet = workbook.Worksheets[0];

// Setting the height of the second row to 13
worksheet.Cells.SetRowHeight(1, 13);

// Saving the modified Excel file
workbook.Save(dataDir + "output.out.xls");

// Closing the file stream to free all resources
fstream.Close();

How to Set the Height of All Rows in a Worksheet

If developers need to set the same row height for all rows in the worksheet, they can do it by using the StandardHeight property of the Cells collection.

Example:

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Creating a file stream containing the Excel file to be opened
FileStream fstream = new FileStream(dataDir + "book1.xls", FileMode.Open);

// Instantiating a Workbook object
// Opening the Excel file through the file stream
Workbook workbook = new Workbook(fstream);

// Accessing the first worksheet in the Excel file
Worksheet worksheet = workbook.Worksheets[0];

// Setting the height of all rows in the worksheet to 15
worksheet.Cells.StandardHeight = 15;

// Saving the modified Excel file
workbook.Save(dataDir + "output.out.xls");

// Closing the file stream to free all resources
fstream.Close();

Working with Columns

How to Set the Width of a Column

Set the width of a column by calling the Cells collection’s SetColumnWidth method. The SetColumnWidth method takes the following parameters:

• Column index, the index of the column that you’re changing the width of.
• Column width, the desired column width.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Creating a file stream containing the Excel file to be opened
FileStream fstream = new FileStream(dataDir + "book1.xls", FileMode.Open);

// Instantiating a Workbook object
// Opening the Excel file through the file stream
Workbook workbook = new Workbook(fstream);

// Accessing the first worksheet in the Excel file
Worksheet worksheet = workbook.Worksheets[0];

// Setting the width of the second column to 17.5
worksheet.Cells.SetColumnWidth(1, 17.5);

// Saving the modified Excel file
workbook.Save(dataDir + "output.out.xls");

// Closing the file stream to free all resources
fstream.Close();

How to Set Column Width in Pixels

Set the width of a column by calling the Cells collection’s SetColumnWidthPixel method. The SetColumnWidthPixel method takes the following parameters:

• Column index, the index of the column that you’re changing the width of.
• Column width, the desired column width in pixels.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
//Source directory
string sourceDir = RunExamples.Get_SourceDirectory();
string outDir = RunExamples.Get_OutputDirectory();

//Load source Excel file
Workbook workbook = new Workbook(sourceDir + "Book1.xlsx");

//Access first worksheet
Worksheet worksheet = workbook.Worksheets[0];

// Set the width of the column in pixels
worksheet.Cells.SetColumnWidthPixel(7, 200);

workbook.Save(outDir + "SetColumnWidthInPixels_Out.xlsx");

How to Set the Width of All Columns in a Worksheet

To set the same column width for all columns in the worksheet, use the Cells collection’s StandardWidth property.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
            
// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Creating a file stream containing the Excel file to be opened
FileStream fstream = new FileStream(dataDir + "book1.xls", FileMode.Open);

// Instantiating a Workbook object
// Opening the Excel file through the file stream
Workbook workbook = new Workbook(fstream);

// Accessing the first worksheet in the Excel file
Worksheet worksheet = workbook.Worksheets[0];

// Setting the width of all columns in the worksheet to 20.5
worksheet.Cells.StandardWidth = 20.5;

// Saving the modified Excel file
workbook.Save(dataDir + "output.out.xls");

// Closing the file stream to free all resources
fstream.Close(); 

Advance topics

• AutoFit Rows and Columns
• Convert Text to Columns using Aspose.Cells
• Copying Rows and Columns
• Delete Blank Rows and Columns in a Worksheet
• Grouping and Ungrouping Rows and Columns
• Hiding and Showing Rows and Columns
• Insert or Delete Rows in an Excel Worksheet
• Inserting and Deleting Rows and Columns of Excel file
• Remove duplicate rows in a Worksheet
• Update references in other worksheets while deleting blank columns and rows in a worksheet